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1 STUDENT REFERENCE MAN'UAL OUTLINE 

INTRODUCTION TO AUTOPSY (PE-T-484) 

• INITIALIZING AUTOPSY 

• EXAMINING DUMPS USING AUTOPSY COMMANDS 

• INTERPRETING AUTOPSY DATA (PRIMOS INTERNALS GUIDE) 

PRIMOS DEBUGGING USING AUIDPSY 

• PRIMOS SUBROUTINE DEFINmONS 

• USING PRIMOS SOURCE USTINGS 

• SYSTEM OONHGURATION INFORMATION 

• CRASH DUMP DEBUGGING APPROACH 

TROUBLESHOOTING FLOWCHARTS 

• MACHINE CHECK HALTS 

• MISSING MEMORY MODULE HALT - MMOD_ 

• SYSTEM HANGS 

• LABELED HALTS - BOOT0/PAGES_/IPAGF/PGMPA_ 

INTRODUCTION TO DOC 

• DOC USER'S GUIDE 

• DOC SITE ADMINISTRATOR'S GUIDE 
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PRIMOS DE BUGGING USING AUTOPSY 



• PRIMOS SUBROUTINE DEFINITIONS 



• USING PRIMOS SOURCE USTITNGS 



• SYSTEM OONHGURATION INFORMATION 



• CRASH DUMP DEBUGGING APPROACH 



SEPT, 19S6 2 . AUTOPSY COURSE 



2 PRIMOS SUBROUTINE DEETNTIIONS 
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2.1 KS-ROUTINES 




AB$SW1PLP 


Routine to read ABBRSW in FIGCOM for Ring 3. 


A(XX)M$J>LP 


Access cominput infa In PUDCXDM for Ring 3 procedure. 


AD$PAIU>LP 


Fuse the ADDISK/SHUTDN command line. 


AD_C3^J>LP 


Process the ADDISK command. 


AINITJTN 


Cold Start initialization (part l). 


ALIPQCPLP 


Process ASYNC line config. Changes for LYNX (ICS)/HAWK. 


AMINrrj»MA 


Initializes AMLC controlleKs). 


AMLCSJ-TN 


Process internal command AMLC 


AMLCXPLP 


Process internal command AMLC 


AMT,DIMJ>MA 


Processes AMLC input and output. 


APROTOJLP 


Select protocol for an ASYNC line. 


ASNDESFTN 


Assign disk and other peripheral devices except magtape. 


ASNLNIPLP 


Assign and unassign ASYNC lines. 


ASNMT$J>LP 


Assign magtape drive units. 


ASRDIMJ>MA 


Clock driven ASR driver (Option-A). 


ASSURW>LP 


ALLOW A USER PROCESS TO ASSURE FT HAS A CERTAIN AMOUNT 




OF CPU TIME LEFl'. 


ASYENDJ>MA 


LOCATES END OF NEW ASYNC SUPPORT MODULES. 


ASYINIJ-'I-N 


INrnALIZF, ASYNC FUNCnONALTTY ON NEW COMMUNICATION 




CONTROLLERS. 


ASYIPQiTN 


PERFORM ROIPQN INITLATJ7.ATI0N ON BEHALF OF CONTROLLER 




ASY PROCESS. 


ASYNDMJMA 


PROCESS ASYNC I/O FOR NEW COMMUNICATION CONTROLLERS. 


ASYNOICPMA 


INFORM THE ASYNC DIM THAT A CONTROLLER IS OK TO BE USED. 


ATSHIJLP 


LINK TO A SEGMENT SET UP BY MKSHlS 


ATSHRIPLP 


ATTACH TO A SEGMENT ALLOCATED BY GTSHR$ 


AUSOJRJLP 


ACCF-SS CURRENT LOG ENTRY FOR A GIVEN USER. 


AU$DRNJ>LP 


SHUT DOWN AN AUSLOG PHANTOM 


AU$GETJ»LP 


RETURN COPY OF CURRENT LOG BUFFERS FOR LOG UTILITY. 


AU$STARTJ>LP 


START UP AUSLOG UTILTTY PHANTOM. 


AU$STATJ>LP 


SHOW CURRENT STATUS OF AUSLOG PHANIOM. 


AU$TSKJ>LP 


ASSEMBLES AUSLOG LOGIN/LOGOUT MESSAGE TYPES BEFORE LOGD^. 


AU$WRTJ»LP 


WPTTF TD AIISTrV; T Df? FH F A- WATT FOP A HATF nTTFFFU 


AUSCX)MJ>MA 
AUSLOGJLP 


AUSLOG COMMON 


AUSLOG BUFFER MANAGER ROUTINE. 


AU_AT.TOWJ»LP 


IS CALLER CONSOLE, ADMIN, OR USER WITH SAME NAME AS 




USER v. 


BADDSKJ'LP 


CHECK FOR LEGAL PRIMOS DISK NUMBER. 


BADGATJ»MA 


BAD GATE HANDLER. 


BCXUPaPLP 
BFGETR-PMA 


BACK UP RETURN PB FOR RING RESTART. 


BUFFERING PACKAGE USED BY MPCDIM, VERDIM 


RTNrri-TN 


COLD START INmALEATION (PART 2). 


BIT_SUBSJ»MA 


BFT MANIPULATION ROUTINES FOR PLP ASSISTANCE 


BROONVJ»MA 


CONVERT BAUD RATE .Sn.ECT ENCODING FROM AMLC TO 




LYNX aCS) FORMAT. 


BREAK$.PMA 


MANAGE QUIT INHIBrr COUN'i'HKS FOR ALL RINGS. 
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BRPDIM.FTN 

FEPOOPLP 

BTPCX:$J»LP 

CIINIPLP 

C1INJ>LP 

OCPATJ>MA 

OCmXJLP 

aiANGE_UIDJ> 
CHAPPTN 

CHG$PWJ>LP 
CHGJSAJLP 
CHOPRLPLP 
CHKABTJ'MA 

CINTrJTN 

CMC$STJ>LP 

CMREASPTN 

CNEQVJMA 

CNFLCTJTN 

CX)MINLPLP 

OOMMSOJ>MA 

CPSSPLP 

C3PS$CAJ>LP 

CPSSCNJLP 

CPS$CUJ>LP 

CPS$DFJ>LP 

C3>S$INJ>LP 

C3>S$NAJPLP 

CPSSRCPLP 

CPS$RGJ>LP 

CPS$SNJ>LP 

CPS$STJ>LP 

CPUID$J»MA 

CRDDIMJMA 

CSTAKWLP 

DA-raSPLP 

DELAYPMA 

DEVCHJLFTN 

DISKIOJMA 

DMQSETJTN 

EXDSSUBPTN 

DROPD_X)J»LP 

DRPDTILPLP 

DSKCHNJ>MA 

DSKEQVJTN 

DUPUOFTN 



PAPER TAPE PUNCH DD^ 



BOOTS A SINGLE PROGRAMMABLE COMMUNICATION CONTROLLER. 

BOOTS ALL PROGRAMMABLE COMMUNICATION CONTROLLERS. 

SINGLE CHARACTER COMMAND INPUT 

SINGLE CHARACTER INPUT. 

DECLARATION OF COMM CONTROLLER PHYSICAL ATTRIBUTE TABLE. 

RETURN THE INDEX INTO THE OCPAT TABLE FOR A GIVEN DEVICE 

ADDRESS. 

CHANGE PROCESS^ UNIQUE ID. 

PROCESS CHAP COMMAND FOR SETITNG PROCESS PRIRORmES 

AND TIMESUCE VALUES. 

CHANGE THE USERS LOGIN PASSWORD. 

CHANGE SYSTEM ADMINISTRATOR. 

CHANG A PROCESS'S PRIORITY LEVEL 

HACK MODULE TO CHECK FOR ABORTS STILL IN THE PCB AND 

PROCESS THEM. 

COLD START CONHGURATION. 

UST COMMUNICATIONS CONTROLLER STATUS. 

OLD STYLE COMMAND LINE PARSER. 

NAMEQV<X)MEQV COMPARE ASCH NAMES. 

CHECK FOR OONFUCTTNG PRIMOS PARTITIONS. 

INITIALIZE THE COMMS SUBSYSTEM AT COLD/WARM START. 

STATIC SEG ALLOCATIONS FOR OOMMS CONTROLLERS. 

CROSS PROCESS SIGNALING SEND SIGNAL ROUTINE 

CROSS PROCESS SIGNALING CLEAR A USER FROM ALL ACL. 

CROSS PROCESS SIGNALING CONTROL ROUTINE. 

CROSS PROCESS SIGNALING CLEAR A USERS USER SIGNALED UST. 

CROSS PROCESS SIGNALING DEFER SIGNAL ROUTINE. 

CROSS PROCESS SIGNALING INITIALIZATION ROUTINE. 

CROSS PROCESS SIGNALING NAME ROUTINE. 

CROSS PROCESS SIGNALING SIGNAL RECEIVED ROUTINE 

CROSS PROCESS SIGNALING REGISTRATION ROUTINE 

CROSS PROCESS SIGNALING WHO SIGNALED ROUTINE 

CROSS PROCESS SIGNALING STATUS ROUTINE 

RETURN THE CPU ID AND MICROOODE REVISION NUMBERS. 

CARD READER DRIVER. 

MANIPULATE/EXAMINE THE CALLING PROCESS'S CONCEALED STACK. 

RETURN THE STANDARD (FS) FORMAT DATE AND TIME 

SET SLOPE OF DELAY CURVE FOR TERMINAL. 

CHECK EXTERNAL DEVICE ASSIGNMENT. 

DISK I/O FOR PRIMOS. 

SET-UP DMQ CONTROL BLOCKS AND BUFFERS. 

COMMAND LINE PROCESSOR FOR PRIMOS IV, 

INVOKE THE DROP DTR COMMAND FROM RING 3. 

DROP THE AMLC OR ICS UNE DTR FOR A DESIRED USER. 

DISK CONTROLLER CHANNEL PROGRAMS. 

CHECK FOR SAME PARTITION OR OVERLAPPING PARTmONS. 

SET/RETURN TERMINAL CONHGURATION WORD. 
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ENCRYPTIPLP 

EPF_PROFn.F.PLP 

ERKLSSJTN 

ERROOMJ>MA 

ERRPRIFTN 

ERjRRTNJTN 

ERTXTSPLP 

EXTLOGJ»LP 

FATALIPMA 

FBTJMA 

FILPAGJ*MA 

FIND_SEOJ>LP 

FORKWJLP 

FRK$CPJ>LP 

GATE_HTBJ>MA 

GATE_JNITJ»LP 

GATE_TABLE__HA 

GCHAIU>MA 

GEMSPBPLP 

GEM$R3J>LP 

GEM$STJ>LP 

GEM$WTJ>LP 

GEMOOMJ»MA 
GETAT$J»LP 
GETIDJMA 
GETSOJLP 

GETSEGJTN 

GErSN$J>LP 

GEr_JPOaVJ>LP 

GEr_SANAMEJ>LP 

GMETRtPLP 

GPGRECPm 

GPIDIMJ>MA 

GTCHANJLP 

GTSHRIPLP 

GTWNDOJ>MA 

HWSTATJLP 

ICS2TCTJMA 

ICSCPGJ>LP 

ICSFPJ>LP 

IN$LOJ>LP 

INSON$J>LP 
lOQSSYJMA 



AcnvrriEs. 
AcnvmEs. 



ENCHYPT A USER'S LOGIN PASSWORD AS IRREVERSIBLY AS 

PRACnCABLE. 

ROUTINE TO RETRIEVE EPF RELATED DATA FROM USER 

PROFILE. 

SET ERASE AND KILL CHARACTERS FOR USER. 

STANDARD ERROR MASSAGE TABLE. 

PRINT SYSTEM ERROR MESSAGE. 

ERROR RETURN HANDLER FOR PRIMOS IV. 

RETURN THE TCXT OF A SFECII-IED ERROR CODE 

RESTORE THE EXTERNAL LOGIN/LOGOUT PROGRAM. 

FATAL PROCESS ERROR. 

DEFINE BUFFER AVAILABILITY TABLE FOR ASSIGNED ASYNC LINES. 

FILL PAGE WITH ZEROS. 

RETURN A VECTOR OF FREE SEGMENT NUMBERS. 

FORK SEMAPHORE DATA ABSTRACTIONS. 

ADDRESS COPY ROUTINE FOR FORKED PROCESSES. 

GATE HTB TABLE. 

INTTIAUZE GATE SEGMENT. 

RING GATES ENTRIES FOR PRIMOS IV. 

GET CHAR FROM ARRAY, STEP CHAR PTR. 

A GATE ROUTINE TO CALL PROBE TO MONITOR RING 

A GATE ROUTINE TO CALL PROBE TO MONITOR RING 

CONTROL PROCEDURE FOR GENERAL EVENT MONITOR (GEM). 

GATE ROUTINE TO WAIT FOR AND DUMP GENERAL EVENT MONITOR 

AND BUFFERS. 

COMMON DEFINmONS FOR GENERAL EVENT MONITOR (GEM). 

READS SYSTEM DEFAULTS AND PASSES THEM TO EDIT PROFILE 

INITIALIZE CONTROLLER AND FETCH ID GIVEN A DEVICE ADDRESS. 

THESE RETURNS MANAGE THE ALLOCATION OF SEG FOR IPON 

BASED DEVICES. 

ALLOCATE A PAGE MAP FOR A NEW SEGMENT FOR SPECIFIED USER 

RETURN A VECTOR OF ALLOCATED SEGMENT NUMBERS. 

ROUTINES TO MANAGE PHANTOM INTERRUPT CODE DYNAMICALLY 

FOR PROGRAM COMMUNICATION DEVICES. 

READ SA N AME FROM SAD INTO SUPCOM 

GET METERING DATA OF VARIOUS SORTS. 

ALLOCATE A PAGING DEVICE INDEX. 

INTERRUPT PROCESS FOR TJGPPI INTERFACE 

GET A DMA OR A DMC CHANNEL. 

DEFINE AND MAP A DTAR2 SEGMENT ONTO A DTARO SEGMENT 

ROUTINE TO ALLOCATE SEGO WINDOWS FOR MAPPED I/O. 

PERFORM A STATUS HARDWARE COMMAND. 

GATE TO ALLOW OTA ANP INA FROM ICS2 MONITOR TO CONT. 

CHECK FOR INOONSISTANdES IN THE ICS CONHGURAHON. 

INmALIZES FREE POOL FOR NEW OMMUNICATIONS CONTROLLERS. 

RETURN STATE OF PPMDJN GRACE PERIOD. 

INITIALIZE A NEW USER. 

INinALJZES A STATIC ON ON-UNIT LISTS. 

IOA$ CALL FOR SYSTEM CONSOLE 
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lOWmEJMA 

lOWNDWJMA 

IPCSCPUP 

IPC$CAJ»LP 

IPC$CMJ>LP 

IPCSGUPLP 
IPCSNCPLP 

IPC$SOJ»LP 

IPC$RJ»LP 

IPCSRAJ>LP 

IPC$SA.PLP 

IPC$SBJ>LP 

IPOSSJLP 
IPC$STJ>LP 

IPC_ACKMJ>LP 
IPC_CKACJ>LP 

IPC_CMBXJ»LP 

IPC_C3^FYJ>LP 

IPC__DBJ>MA 

IPC_FATALJ»LP 

IPC_GIDPJ>LP 

IPC_GUIDJ>LP 

IPC_GUNMJ>LP 

IPC_NFYRJ»LP 

IPC_SALLJ>LP 

IPQBLPMA 

IPQBSPJ>LP 

IPQCSJLP 

IPQDEFJ»MA 

IPQENDJ»LP 

IPQICPJ»LP 

IPQNMJ*MA 

IFQPLPMA 



WIREAJNWIRE PAGES FOR PERFORMING L'O. 

OPEN MAPPED I/O WINDOWS. 

CLOSE A IPC MAILBOX USING THE MBX ID SPECIFIED. 

CLOSE ALL MAILBOXES THE CURRENT USER OWNS. 

CHANGE MAILBOX ACCESS MODE FROM READ/WRITE TO SPECIFIED 

MODE. 

GET THE DESIRED MAILBOX USER ID SPECIFIED BY KEY. 

CLOSE A IPC MAILBOX WITH NOITHCATIONS USING THE MBX 

ID SPECIFIED. 

OPEN AN IPC MAILBOX FOR SPECIFIED ACCESS USING PATHNAME 

FOR ACL. 

RECEIVE A MASSAGE FROM SPECIFIED IPC MAILBOX WATTING. 

RECEIVE A MESSAGE FROM ANY IPC MAILBOX OWNED BY THE USER. 

SEND A MESSAGE TO ANY IPC USER ATTACH TO SPROFIED 

MAILBOX. 

SEND A MESSAGE TO ALL IPC USERS ATTACHED TO SPECFEED 

MAILBOX. 

SEND A MESSAGE TO A SPECIFIED IPC USER. 

RETURN VARIOUS IPC STATUSES DETERMINED BY USER SPECIFIED 

KEY. 

ACKNOWLEDGE A SPECIFIED MAILBOX MESSAGR 

CH ECK A CCESS TO A MAILBOX BY A SPE CIFIED KEY FOR A 

SPECIFIED MAILBOX USER ID. 

CLOSE A MAILBOX FOR THE SPECIFIED MAILBOX USER ID 

IN THE LOCAL DATABASE 

CLOSE A MAILBOX WIFH NOTIHCATION. 

DEFINE STATIC STORAGE FOR THE IPC MECHANISM. 

SEND A FATAL ERROR MESSAGE TO THE SYSTEM CONSOLE 

GET MAILBOX USER ID (MBX UCTL) POINTER. 

GET A SPECIFIED USER'S MAILBOX USER ID POINTER. 

GET NEXT MESSAGE FOR SPE CIFIED RECEIVER. 

INTERRUPT A SPECIFIED IPC USER BY MAILBOX USER ID. 

SEN D A MESSAGE OF A SPECIFIED TYPE TO ALL USERS OF A 

SPECIFIED MAILBOX. 

THE CHEAP PROCESS TO HANDLE BUFFER SERVICE FOR THE 

INTELLIGENT CONTROLLERS. 

CHEAP PROCESS TO DO BUFFER SERVICE FOR THE INTELLIGENT 

CONTROLLERS. 

ROIPQNM INITIALIZATION AND DELEHON ROUTINES FOR THE 

BASIC STRUCTURES. 

IPQNM COMMON DEFINmONS. 

THIS MARKS THE END POINT OF THE WIRED CODE FOR ROIPQNM. 

PROCESS TO HANDLE INTERRUPTS FOR THE INTELUGENT 

COMMUNICATION CONTROLLERS. 

QUEUE HANDLING ROUTINES FOR INTELUGENT CONTROLLER 

PRODUCTS. 

HANDLES INTERRUPTS FOR THE COMMUNICATIONS CONTROLLERS 

FOR ROIPQNM. 
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JOB$OJ>LP 
LC3DEI-PLP 

LONTSJLP 

LGINISJLP 

UMTTIPLP 

LISTEN JLP 

LOGKPGPTN 

L0OABTJ>LP 

IjOGEV1J>MA 

L0OEV2JTN 

LOGINIPLP 

LCX30$$JTN 

LOGOSCPJLP 

LOGOGMT_J>MA 

L0GOCM_J»LP 

LOGOUTJLP 

LOG_JNrrJ>LP 

LONSCPLP 

LON$OJ>LP 

LONSSPLP 

LOVSSWJLP 

LO_CLEANJ>LP 

LO_FATALJ>LP 

LUDEVtPLP 

MAPIOJiMA 

MAPSEGJTN 

MEMDATi>MA 

MESSAOJTN 

MESSGIFTN 

MGSETWTN 

MINABTJTN 

MKSHLIPLP 

MMAPJMA 

MOVEtPMA 

MOVSEOJPLP 

MOVXJTUJTN 

MP2DIKLPMA 

MPCDIMPMA 

MSGIFTN 

MSOSSTPTN 

MSGOOMPMA 

MSOOUTJ»LP 

MTDIMJ>MA 



OPERATES ON BATCH QUEUE CONTROL FILE IN A SECURE MANNER. 

PROCEDURE TO DELETE A LOGICAL CONNECnON FOR THE IPQNM. 

ROUTINES 

SUBROUTINE TO INITIALIZE A LOGICAL OONNECnON FOR THE 

IPQNM ROUTINES. 

TURN ON AND OFF OS AND NETWORK LOGGING. 

SET/READ CPU, REALTIME, AND LOGIN TIME LIMTTS. 

RING ZERO (LOGGED OUT) LISTENER. 

WIRE AN AEEA OF THE VIRTUAL MEMORY. 

HANDLE LOGOUT PROCESS ABORTS (FORCED AND TIMEOUTS). 

FIRST-LEVEL EVENT LOGGING. 

SECOND-LEVEL EVENT LOGGER. 

RING ZERO LOGIN COMMAND PROCESSOR. 

SUBROUTINE TO LOGOUT A USER OR USERS. 

LOGGED OUT COMMAND PROCESSOR. 

LOGGED OUT COMMAND TABLE. 

DECIDE WHETHER A GIVEN COMMAND IS A VALID LOG OUT. 

LOGOUT INTERFACE (R3 TO RO) AND MESSAGE SENDER. 

RESET PARAMETERS AFTER LOGOUT OR BEFORE LOGIN. 

CLOSES A USER'S LOGOUT NOTinCATION MESSAGE QUEUE. 

LOGOUT NOnnCATION REVEIVER MESSAGE QUEUE OPENER. 

LOGOUT NOnnCATION PHANTOM MESSAGE SEND MODULE. 

ROUTINE TO READ LOGOVR IN FIGCOM FOR RING 3. 

CLEAN UP AFTER EXTERNAL LOGOUT OR LOGIN ERROR. 

MAIN LOGOUT PROCESSOR, CALLED BY LOGOUT AND FATALS. 

LIST A USER'S ASSIGNED DEVICE 

LOCK AND MAP (AND UNLOCK) USER BUFERRS INTO SEGMENT 0. 

MAPS A SEGMENT ALREADY DEFINED IN DTAR TO ANY 

OTHER SEGMENT. 

DEFINE MEMDAT (MEMORY USEAG DATABASE) COMMON AREA 

HANDLE MESSAGE COMMAND. 

HANDLE MESSAGE COMMAND. 

SETS MSG RCV STATE FOR USER. 

HANDLE 1 MINUTE PROCESS ABORT. 

AIXOCATE PURE DTAR2 SHARED SEGMENT. 

MEMORY MAP DATABASE FOR PRIMOS MEMORY MANAGEMENT. 

DATA MOVEMENT SUBROUTINES. 

COPY A CURRENT USER'S SEGMENT FROM ANY OTHER SEGMENT. 

MOVE WORDS FROM ONE USER'S VIRTUAL ADDRESS SPACE TO 

ANOTHER USER'S VIRTUAL ADDRESS SPACE. 

DRIVES LINE PRINTER. CARD READER. CARD PUNCH VIA MPC«'2. 

DRIVES LINE PRINTER. CARD READER. CARD PUNCH VIA MFC 

SEND A MESSAGE TO A USER ON ARBRTTARY NODE 

RETURN MESSAGE STATUS TO CALLER. 

MESSAGE COMMON. 

MESSAGE FAdLTTY - OUTPUT MESSAGE TO USER. 

DRIVES MAG TAPE VIA MPC 
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\rti nrir nxM A 

NOCFPDJMA 
NLKOOMJMA 
NLOGINJLP 
NS4_NTFYJ>LP 

OERRTNJTN 

ORGOi>MA 

PABAORTJTN 

PAGSFSPLP 

PAGINIFTN 

PAGTURJTN 

PBDIOSJ>MA 

PBH$ONJU> 

PBTABLPMA 

PCBINLFTN 

PCBPTR_J>LP 

POC$HTJ»LP 

POC$RAJ>LP 

POC$URSJ>LP 

PCC$WMJ>LP 
POCBSJ>LP 

POCDLLJ>MA 

POCSOJ»MA 

POC_DCLJ>MA 

PGFSTKJMA 

PGMAPAJ>MA 

PGMAPSJ>MA 

PHLOGINJ>LP 

PHTTYREQJPLP 

PHYSADJMA 

PID$C3CPLP 

PID$GETJ>LP 

PIOJ>MA 

PMPRIKLPMA 

PMSGIFTN 

PRERRJTN 

PRI$RVJ>LP 

PRJm$J>LP 

PRNSSTPTN 

PROBEPLP 

PROBE_UTILSJ>MA 



COMMON AREA FOR IMCS FREE POOL ID. 

NON-WIRED COMMON. 

MAIN LOGIN ROUTINE FOR NORMAL USERS. 

ROUTINE TO NOTIFY NS4 USRSEM IF PROCESS IS WATTNG OR 

ABOUT TO WATT ON A SEMAPHORE. 

OLD STYLE ERROR HANDLING. 

SETS LOADER WDNO TO ZERO. 

HANDLE PROCESS ABORT CONDmONS (NEE SCHED). 

PAGE TO/FROM THE FILE SYSTEM (1040 WORD-RECORD DEVICES). 

PRIMOS PAGING MECHANISM COLD START INmALIZATlON. 

TURN PAGE(S) IN RESPONCE TO A PAGE FAULT. 

PAPER TAPE READER, PUNCH, PRINTER I/O RELATED ROUTINES. 

PB HISrOGRAM FAdLTTY STARTUP/ACCESS ENTRIES. 

DATA AREA FOR PB HISTOGRAM. 

PCB INTITALIZATION FOR COLD START. 

RETURN POINTER TO A SPECIFIED USER'S PCB. 

BREAKS IPQCS LINKS TO THE PROGRAMABLE CONTROLLERS. 

REINITIALIZES ASYNCHRONOUS SERVICES: LYNX AND AMLC. 

REINITIALIZATION FOR THE PROGRAMMABLE CONTROLLER 

SYNCHRONOUS SERVICE 

WARM-STARTS THE PROGRAMMABLE CONTROLLERS. 

"pccbs- LOADS AN EXECUTABLE FILE INTO A PROGRAMMABLE 

CONTROLLER. 

DEFINES AN AREA IN SEG FOR PROGRAMMABLE CONTROLLER 

DOWN LOADING. 

DEFINES AN AREA IN SEG FOR PROGRAMMABLE CONT. DATABASES. 

DEFINES SOME STORAGE AREAS FOR PRCX3RAMMABLE COMM. CONT. 

PUDCOM AND PAGE FAULT STACK FOR USER 1. 

ROUTINES TO RETRIEVE SDW AND PAGE MAP POINTERS. 

START OF ALL THE PAGE MAPS IN THE SYSTEM. 

LOGIN A PHANTOM USER. 

FORCE A PHANTOM TO LOGOUT AFTER AN ILLEGAL REQUEST. 

THIS CONVERTS VIRTUAL TO PHYSICAL ADDRESSES (DTAR 0,1) 

FOR IPQNM. 

VALIDATES A PROCESS'S UNIQUE ID. 

GET THE PID OF THE CURRENT PROCESS. 

ROUTINES TO CONSTRUCT AND PERFORM PIO INSTRUCTIONS. 

PAGE MAP PRIMTTTVES FOR USE IN ACCESSING PRIMOS PAGE MAPS. 

PRINT INT1ER USER MESSAGE 

PRINT NAME AND/OR MESSAGE FROM USER'S ERRVEC 

RETURNS THE PRIMOS REV. STAMP OF THE CURRENTLY RUNNING 

OPERATING SYSTEM 

RETURN PROJECT ID OF CURRENT USER. 

PRINT SYSTEM STATUS ON- USER TERMINAL. 

GENERA L EV ENT MONITOR PROBE ROUTINE - WRITES RECORDS 

INTO BUFFER. 

PMA UTTLTTIES FOR THE PROBE ROUTINE OF GENERAL 

EVENT MONITOR (GEM). 
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PTRAPJTN 

PTRDIMJTN 

ROBASEJPMA 

ROFALTJMA 

ROUILPMA 

R3CAIJLPMA 

REMLISJPTN 

REPLYSJTN 

REQLCDJ>MA 

RMKSHLJ>LP 

RMSODIFTN 

RMSm-PMA 

RMSHRJLP 

RSEGACIPLP 

RSEGACUJ»LP 

RTIME$J>MA 
RTNSG$J»LP 

RTNSG2JMA 
RTNSOaPTN 
RWRECPLP 
S$ATRJ»LP 

SUTRRPLP 

S$ATRGJ»LP 

SAL_SYSTJ>LP 

SANAM$J>LP 

SCH$RDJ»LP 

SCH$STJ>LP 

SCHARJ>MA 

SCHEDJMA 

SEGOJ>MA 

SEG14J»MA 

SEG4J>MA 

SEGAC$J>LP 

SEMSCAPLP 

SEM$CLJ>LP 
SEM$DRJ>LP 
SEM$NFJ>LP 
SEM$OPJ>LP 

SEM$OUJ>LP 

SEM$CTJLPNAMED 



RESTRICTED MODE TRAP HANDLER. 

PAPER TAPE READER DIM. 

GET A POINTER TO THE FIRST FRAME ON THE RINGO STACK. 

RINGO FAULT HANDLER. RING UTILITY SUBROUTINES. 

SPECIAL (QUICK31ALL STACK FRAME) UH FJJ^. FOR RINGO. 

RING 3 CALL TABLE. 

PROCESS THE REMLIN COMMAND. 

OPERATOR/USER COMMUNICATION FAOLnY. 

SIGNALS THAT CHEAP PROCESSES HAVE REQUESTED LOGICAL 

CONNECT DELEnON. 

REMOVE A SHARED PURE DTAR2 SEGMENT FROM HE WORLD. 

RETURNS CONTENTS OF PER USER MESSAGE BUFFER TO CALLER. 

DETACH A SHARER FROM A PURE DTAR2 SHARED SEGMENT. 

DETACH A SHARER FROM A DTAR0/DTAR2 SHARED SEGMENT. 

FUNCnON WHICH RETURNS PER RING ACCESS TO THE SEGMENT 

IF THE SEGMENT IS IN USE. 

FUNCnON WHICH RETURNS PER RING ACCESS TO ANY USER'S 

SEGMENT IF THE SEGMENT EXISTS. 

RETURN REAL-TIME AS 48-BrT VALUE IN PIC COUNTS. 

RETURNS ON SEGMENT OR ALL PRIVATE SEGMENTS IN A 

USER'S PROCESS. 

INTERLUDE TO RTNSG3. 

DOES THE DIRTY WORK OF RELEASING A SEGMENT. 

HANDLE READ AND WRITE REQUESTS FOR ASSIGNED DISKS. 

READS SYSTEM DEFAULTS FROM THE SAD AND PUTS THEM INTO 

EPFCOM. 

SETS UP DEFAULT ATTRIBUTES CiN MEMORY COPY) FOR SYSTEM. 

RANGE CHECK FOR ATTRIBUTES. 

SYSTEM CLASS STORAGE ALLOCATOR. 

RETURN THE NAME OF THE SYSTEM ADMINISTRATOR. 

SCHEDULAR VARIABLE READ SUBROUTINE. 

SCHEDULAR VARIABLE SET SUBROUTINE 

STORE CHARACTER INTO ARRAY, STEP CHARACTER POINTER. 

PRIMOS IV SCHEDULING ROUTINES. 

SEGMENT MODULE. 

SEGMENT 14 MODULE. 

SEGMENT 4 MODULE. 

SUBROUTINE TO SET SEGMENT ACCESS. 

NAMED SEMAPHORE ROUTINE TO CLOSE ALL SEMAPHORES AT 

LOGOUT TIME. 

NAMED SEMAPHORE ROUTINE TO CLOSE AN OPEN SEMAPHORE 

NAMED SEMAPHORE ROUTINE TO DRAIN A SEMAPHORE 

NAMED SEMAPHORE ROUTINE TO NOTIFY A SEMAPHORE 

NAMED SEMAPHORE ROUTINE TO OPEN A SEMAPHORE 

ASSOCIATED WFTH A FILENAME 

NAMED SEMAPHORE ROUTINE TO OPEN AND INTTIALIZE A 

SEMAPHORE 

SEMAPHORE ROUTINE TO REPORT STATUS OF SEMAPHORES. 
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SEM$TNJ»LPNEMAED SEMAPHORE ROUTINE TO SET A TIMER FOR A SEMAPHORE. 



SEMSTSJLP 
SEM$TWJ>LP 

SEM$WTJ>LP 
SEMUTLPLP 
SEMVQA-PLP . 

SEMVQRJ>LP 
SEMVQSJLP 

SETAOCPLP 
SETASDJMA 
SETCPUJMA 
SET_INFOJ>LP 

SFR_SYSTJ>LP 

SGINFOJLP 

SHARESEGJ>MA 

SHRLIBJTN 

SHUTDNJFTN 

SH_C3^roJ>LP 

SIDSGTJLP 

SISSHOJ>LP 

SISSH1J>U> 

SISSH2J>LP 

SISSH3J>LP 

SMSGSFm 

SNAP$OJ>LP 
SNDBULPLP 
SOROSPLP 
SPAWNIPLP 

SRPHANJLP 

SRWRECFTN 

STKINLFTN 

STNOUJ>MA 

SUPSTKJMA 

SUSRIPLP 

SVCALIPMA 

SV CALPARJLP 

SW$ABTJ>LP 

SW$ADJ>LP 

SWSINTJLP 

SW$MKRCSJ>LP 

SW$ONJ»LP 

SWJROOFFJLP 

SW$RAOFJ>LP 



NAMED SEMAPHORE ROUTINE TO TEST A VALUE OF A SEMAPHORE. 

NAMED SEMAPHORE ROUTINE TO WATT ON A 

SEMAPHORE AND TIMER. 

NAMED SEMAPHORE TO WATT ON A SEMAPHORE. 

NAMED SEMAPHORE UTILITY ROUTINES. 

NAMED SEMAPHORE ROUTINE TO ADD A PROCESS TO A VIRTUAL 

SEMAPHORE QUEUE. 

NAMED SEMAPHORE ROUTINE TO REMOVE A RANDOM PROCESS. 

NAMED SEMAPHORE ROUTINE TO REMOVE TOP PROCESSES FROM 

VIRTUAL SEMAPHORE QUEUE. 

SUBROUTINE TO SET SEGMENT ACCESS. 

SETUP AUTO SPEED DETECT PROTOCOL FOR A GIVEN LINE. 

LOCK/UNLOCK PROCESS TO NASTER CPU. 

SET AND CHECK VALUES OF INFO STATUS FOR PRIME 

INFORMATION. 

FREES SPACE FROM SYSTEM CLASS STORAGE. 

RETURN INFORMATION ABOUT A SEGMENT. 

DATA FOR SNA SHARED SEGMENT UnLTTY. 

INSTALL SHARED LIBRARY CRESTRICEED TO USER <SUSR>). 

SHUTDOWN COMMAND PROCESSING FOR PRIMOS IV. 

PROCESS THE SHUTDOWN COMMAND. 

GET SPAWNER-S ID 

A SEGMENT IS BEING SHARED OR NOT. 

A SEGMENT IS SHARED OR NOT. 

A SEGMENT IS SHARED OR NOT. 

A SEGMENT IS SHARED OR NOT. 



REPORTS ON WHETHER 
REPORTS ON WHETHER 
REPORTS ON WHETHER 
REPORTS ON WHETHER 



SEND A MESSAGE TO A USER ON AN ARBITRARY NODE (USER 

CALLABLE). 

SNAP A DYNAMIC LINK INTO RINGO Oe. A GATE). 

SEND AN ASYNC CONTROL BLOCK TO A NEW OOMM CONT. 

INVOKES UST OF RINGO STATIC ON-UNITS. 

SPAWN A NEW PROCESS WITH ATTRIBUTES PARTIALLY 

SPECIFIED BY SPAWNER. 

APPLY SUFFIX SEARCH CONVENTIONS FOR PHANTOM LOGINS. 

SVC HANDLER FOR RREC, WREC SVC 

INITIALIZATION OF RING STACK SEGMENTS. 

SVC-PCL INTERLUDES TO TNOU, TNOUA 

UNWIRED RING STACK FOR USER 1. 

Returns whether or not caller is user 1. 

MISCELLANEOUS SUPERVISOR ENTRIES. 

Do all the validation for a system variable setting. 

Handle Software Interrupt Process aborts for the 

current process. 

Routine to cause a ring rotltine to be restartable 

if a so abort is deferred. 

Software Interrupt Enable Control Module. 

Makes A Reverse Critical Section. 

Turns On The Specified Software Interrupts For Ring 3 

Turns Off Specified Software Interrupts For Ring 

Reads And Then Turns Off All Present Interrupts For 

Ring 3 



SEPT. 1986 



11 



AUTOPSY COURSE 



SW$RSTJ>LP 
S_ADD_OJ>LP 
S_ADD_2J»LP 
S__CNJN_2i>LP 

S_FULL_OJ>LP 
S_FULL_2J»LP 

S_FULL_XJ»LP 

S__GErKEYJ»LP 

S_JNDEXOJ>LP 

S_JOIN_0J>LP 

S_J0IN_2J>LP 

TJAMLCPLP 

TSCMPCPTN 

TSGPPLPLP 

T$GSJ>MA 

TSLMPCFTN 

T$MGJ»MA 

TSPMPCFTN 

TSTMJMA 

TSVGJTN 

TAIFTN 

TDUMPCJPMA 

TERM$LPLP 

TTLADJJLP 
TFUOtPMA 
TI$MSGJ>LP 

TIMDATJMA 

TMAINJ>MA 

TODECPLP 

TP$OONJ>LP 

TP$DISJ>LP 



Reset Ring Software Interrupt Enable Mechanism. 
Adds an entry to EXTARO/l shared segment table. 
Adds a new entry to pure DTAR2 shared segment table. 
Returns truth value of Ture DTAR2 uid exists and is 
attachable" 

Returns true if and only if the DTARO/1 share tables are f 
Returns truth value of "Share toble for DTAR2-only segs is 
full" 

Returns true if an only if the DTARO/1 share table s 
table is f ulL 

Attempts to retrieve first two words from specified file 
Returns truth value of "Index of specified uid in most rec 
Adds a new attacher to a given uid in the DTARO/1 shared 
table. 

Attach an entry in pure DTAR2 shared segment table. 
Raw data mover for amlc lines. 
I/O TO CARD READER/PUNCH VIA MFC 
General purpose parallel interface routine. 
DRIVER FOR VECTOR GENERAL GRAPfflCS TERMINALS 
LINE PRINTER OUTPUT VIA MFC 
DRIVER FOR SOC-MEORAPfflC 7000 INTERFACE 
CARD PUNCH I/O VIA MFC 

PRIMOS DIRECT-CALL HANDLER FOR TAG MONITOR 
VERSATEC-GOULD PLOTTER I/O 
Obsolete tree attach (processes register settings). 
Define the symbol TDUMPC and cause seg to allocate space. 
SET/RESET TERMINAL PARAMETERS FOR USE WITH THE INFORM- 
ATION PRODUCT. 
Adjust size of tfliob buffers 
LOGICAL I/O BUFFERING ROUTINES. 
Print a message summarizing connect, cpu, and I/O time 
utilization. 

DATE AND TIME CONVERSION ROUTINES. 
CLOCK PROCESS, RING UTILITY SUBRS. 
Print decimal or octal integer on any user's terminaL 
Terminal-Process connect amlc line 
Terminal-Process disconnect for amlc lines 
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TPLOGOJLP 

TPUT_SAVJ>MA 

TRMBUF$GJ>LP 

TRMPID$$J>LP 
TTY$INJ>LP 

TTYSRSPLP 

TTYPERPMA 

TUnLSJMA 

UID$BTJ>LP 

UIDSOLPLP 

ULOKPGJTN 

UNO$GTJ»LP 

USERIFTN 

USNMTU>LP 

USRASIFTN 

UTTLIPMA 

UTYPE$J>LP 

VERDIMPMA 

WATITNJMA 

WARMSTJ>MA 

WIRSTKJTN 

WRLIPLP 

WRMABTJTN 

XTDISOJLP 



DAni7 TTTDKTTVr^ TVTT7DT TTT^T? fV% r*TeV T/n 



Do TP logout cleanup 

DEFINE STORAGE AREA FOR SAVED USER TYPES FOR TP 

Get the number of the terminal parent's I/O buffer 

and aid 

Maintains aU process's terminal parent id attributes. 

Gate to check if there are any characters in the tty input 

buffer for user. 

Routine to dear a process's I/O buffers, 

Typtn (terminal output routines). 

RANDOM SUBROUTINES 

Generate unique id as a bit string. 

Generate a imique identifier as a character string. 

UNWnUE AN AREA OF THE VIRTUAL MEMORY. 

Get the id's associated with this user. 

Retreive ringO data. 

Unassign magnetic tape drive units. 

Process the USRASR command. 

UnUTY SUBROUTINES FOR FORTRAN PROGRAMS 

Function to return type of user Giormal. remote, phantom) 

PRIMOS 4 DRIVER FOR SOC INTERFACE 

WATT WITH PROCESS EXCHANGE INfflBTITED. 

IS A WARM STARTABLE HALT ROUTINE 

Procedure to wire the page fault stack for a process. 

ESTABLISH WHICH RINGS STACK OF STATIC ON UNITS TO BE ACCESS 

HANDLE WARM START PROCESS ABORT. 

Extend the allocation of seg for IPQNM. 
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2^ FS-ROUTINES 



AC$CATJ>LP 

AC5DFTJ>LP 

ACSLSTJLP 

AC$RVTJ>LP 

AC$SETJ>LP 

AOC_CHKJLP 

ACDEOODEPLP 

ACENCX}DEPLP 

ACXSEGJ>MA 

AC_CLEANJ>LP 

AC_DELPAJ»LP 

AC__NEWPAJ>LP 

ADD_ENTJ>LP 

ADD_JIECPLP 

ALC_RECPLP 

ATSJ'LP 

AT$ABSJ>LP 

AT$ANYJ>LP 

ATSHOMPLP 

AT$INVJ>LP 

AT$ORJ>LP 

ATSRELPLP 

AT$TMPJ»LP 

ATCH$$J>LP 

ATLISTJLP 

AT_JU)REM1>LP 

AT_BADPWJ>LP 

AT_CUEANJ>LP 

AT_UNREMPLP 

AT_VALPARi»LP 

CALACSJPLP 

CALACSPLP 

CAT$DLJ>LP 

CmMODJ>U> 

CLSFNIIPLP 

CLO$FNJ>LP 

CLO$FUJ>LP 

CLOSEPLP 

CNAMSIPLP 

CX>$GErj»LP 

OOMI$$J>LP 
(X>MO$iPLP 

CX3PY_APJ>LP 

CX)PY_UTEPLP 
DAMDATA-PLP 



Place an object into an access category. 

Piotea an objea with default access rights. 

Return the contents of an ACL in logical format. 

Revert an ACL directory to password protection. 

Create an ACL. 

Handle access checking for access-setting routines. 

Decode a physical ACL entry into a logical one. 

E n c ode logical <id>:<aooe8B> pair into physical ACL 

entry 

ACL system databases. 

Common cleanup for ACL gates. 

Delete a priority ACL for a specified logical device. 

Add a new priority ACL to the specified LDEV. 

Add a new entry to a directory. 

Extend a file. 

Allocate recordCs) for new directory entry. 

Attach to the specified pathname. 

Attach to a top-level directory on a specified partition. 

Do an attadi scan. 

Set current attach point to be same as home. 

Invalidates specified attach pointCs). 

Set home and/or current attach points to be same as initia 

Attach relative to the current attach point. 

Save or restore the current attach point. 

Writearound for new attach modules. 

Do a local attach scan on a specified list of disks. 

Set unit table entry for attach point just gone remote. 

Signals BAD PASSWORDS for attach routines. 

Common cleanup for attach modules. 

Invalidate remote attach pointCs). 

Validate key and directory name for ATS routines. 

Calculate accesses available on a named object. 

Calculate accesses. 

Delete an access category. 

Change the open mode of an open file. 

Close a file by name and return a bit varying indicating 

closed units. 

Close an open file by wn^f - 

Qose an open file b7 unit. 

Qose a file by lume CBRA/devioe number) or unit 

Change the name of a file system object. 

Retrdve ringO data for invoking CLOSE and COMOUTPUT command 

in rings. 

OOMINPUT COMMAND AND SVC HANDLING 

OOMOUT-PUT COMMAND/SVC HANDLER - SWITCH COMMAND 

OUTPUT ON/OFF 

Copy one attach point to another, handling hashing and 

quotas. 

Copy one unit table entry to another. 

Calculate the first data record for a DAM type file. 
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DEL_ENTJ'LP Rsmove a directory entry. 

DIR$CRJ»LP Create a directory. 

DIIl$RDJ>LP Read physical directory entries. 

DOPOSIPLP Do positioning on an open file. 

DOSUFFIXJ>LP Scan a directory for a (possibly) suffixed entry same. 
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EMP1Y_CKJLP 


Make sure the object whose BRA is passed may be deleted. 


ENTINDIRJ'LP 


Attach to directory, return entrv name in it. 


Fli,$Dl>PLP 


Delete a file or directory. 


FIL_C3U>LP 


Create a named file. 


F1L_EXJ>LP 


Check existence of a named uf d entry. 


FIL_OPJ»LP 


Open a named file. 


FIND ENTJ>LP 


Find an entry in the directory specified by the unit table 




entry. 


FIND_HOT.F-PI.P 


Find the first available hole <^ the required size in a 




directory. 


FINFOIPLP 


Return information about specified file unit. 


FORCEWJLP 


Force a file to be written to disk. 


FREF_RECPLP 


Free a file's records when it is deleted. 


FSAHSHJ>LP 


Add a unit table entry to file system and/or ACL hash 




threads. 


FSHASHJMA 


Calculate the hash index for the unit table. 


FSUHSRPLP 


Remove a umt table entry from file S3rstem and/or ACL hash 




threads. 


Gt'llDSJLP 


Returns a user's complete ID (user id plus group ids). 


GETQBJLP 


Return a pointer to the directory/quota block & increment 




use count. 


GETRECPLP 


Get a free record in a logical partition by searching RAT. 


Gfl'UNJLP 


Get a unit table entry from the system-wide pooL 


GET_XDEVJ>LP 


Convert partition name to logical device number. 


GOODUNITJ>LP 


Check the validity of a unit number. 


GPAS$$J>LP 


Read passwords on named directory. 


GPATHJJLP 


Return a pathname given a unit, attach point or segment 




number. 


GSG_RAJ>LP 


Return segdir entry number by matching BRA in record LOCAT 




by caller. 


GUF_JIAJ>LP 


Return directory entry by matching BRA in dir defined by 




current LOCATE buf. 


HASH_TRT.S.PMA 


Miscellaneous f iles3rstem hash tables. 


ISACL$J>LP 


Indicates whether specified unit is an ACL directory. 


KICKQBJ>LP 


Increment quota block use count for a subtree. 


T.DISKlplp 


Return a list of disk names. 


LDSKUtPLP 


List all users using a given partition. 


LOCATEJMA 


PRIMOS Fn.F SYSTEM ASSOCIATIVE BUFFERING. 


LSMCX3MJ>MA 


Table containing added disk information. 


LUDSKIPLP 


Return a list of all disks in use by a given user. 


LUID$J»LP 


Description: Return a unique ID consist of the Idev and BRA 


M2SMAtPLP 


Return unit number in slave given unit in master. 


MARKUTJLP 


Mark unit table when a disk error occurs. 

Return a pointer to the unit table entry of the given unit. 


MKUTEPTItPLP 


MOVNAMJ>MA 


Move names between two fields 


NAMEQtFTN 


COMPARE TWO NAMES FOR EQUIV (RET TRUE IF SAME) 


NCLBITJ>LP 


Turn on/off the no^lose bit for a file unit. 


NHWDAMJLP 


Add record to new partition dam file. 



SEPT. 1986 



16 



AUTOPSY COURSE 



NEW_ACU>LP 

OPENIFILEJ>LP 

OPEN_CHKJ>LP 

PA$DELJ>LP 

PARJRVJLP 

PK2LDVJLP 

PRWFSSJ'LP 

Q$R£ADJ>LP 

Q$SEri>ILP 

Q_TRWKJ»LP 

Q_UPDTJ>LP 

R/W_ENTJ>LP 

RA2PTHJ»LP 

RDENSIPLP 

RDUNIPLP 

RDLN$XJ>MA 

REMSHTJ»LP 

RESTSSJTN 

RTNQBJLP 

RTNRECPLP 

RTNUNJ>LP 

RVKID$J>LP 

RWLKCKJLP 

SATM$J>LP 

SAVESSJTN 

SEMSEGJMA 

SEnD$J>LP 

SEr_DTMPLP 



open a file (possibly allocating a unit) and return the unit 

Check to see whether or not a file unit is open. 

Delete a priority ACL. 

Returns the partition rev. stamp of a named disk partition 

Convert disk pack name, remote system name into an LDEV 

Moves data to and from file^ also does positioning of fi 

Read quota information for current directory. 

Set quota fields on specified directory. 

Count records used in a subtree. 

Update directory headers -with quota informatixm. 

Read or write the directory entry at the specified position 

Return PATHNAME : <disk namotree name based on BRA and L 

Writearound for RD£N$$ gate. 

Read a line from a file. 

SUBROUTINE TO EXPAND LINE READ FROM FILE. 

Shutdown aU remote disks on the system. 

Restore memory-image R-mode run file ("SAVE" file). 

Return Quota Block. 

Return specified record to logical device's free list. 

Return a imit table entry to the global pooL 

Revokes indices AGTIDX into Active Group Table for given 

user. 

Check unit tobies for conflict with specified file, open 

desired, and r/w lock setting. 

Set attributes for specified file. 

Save memory image 

NAMED SEMAPHORE DATA AREA 

Adds a group into the specified user's Active Group List. 

Set date/time modified of specified file entry to current 

date/time. 
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SET_ORJ>LP 

SEr_QMODJ>LP 

SGDSDLJLP 

SGD$EXJ>LP 

SGD$OPJ*LP 

SGDRSIPLP . 

SGD_JIEJ»LP 

SGD_WEJU> 

SPASSIPLP 

SROmPTN 

SYS_OPENJ>LP 

TEXTOKJ»MA 

TRUNC$J>LP 

TRWRATJ>LP 

UKC3CQBJLP 

UNTTSIPLP 

UTALOCPLP 

UTDALCPLP 

viNrr$j>LP 

WTUNSJLP 
WTLNSCPMA 



Set initial attach point (origin). 

Set modified bit in a quota directory block. 

Delete a segment directory entry. 

Check the existence of a segment directory entry. 

Open a segment directory entry. 

Manipulate segment directory (open status demanded). 

Segment directory read entry. 

Segment directory write entry. 

Set passwords on current directory. 

Open, dose, delete, diange access on, check existence of 

fUes. 

Open a directory on the system unit or some othe imit. 

TECTS FOR A VALID S-CHARACTER FILE NAME 

Truncate a file at the Unit Table Entry's rel wordno & rel 

recno. 

Startup/shutdown a filesystem partition. 

Decrement quota block use count for a subtree. 

Get the current unit number bounds. 

Allocate a unit table for a user. 

Deallocate a users unit table. 

Subroutine to initiate a VMFA segment 

Write a line to a file. 

SUBROUTINE TO COMPRESS LINE WRITTEN TO FILE. 
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23 RSS-ROimNES 



SCALLSJTTJ 
ABBREVJLP 
AB_FILE_J>LP 
AB_GET_J>LP 

AB_JCS_J»LF 

AC$CHGJ>LP 

ACSLDCPLP 

AC$PAIU»LP 

ADD__RENaD__J'LP 

AIjC$RAJ>LP 

ALOC$$J»MA 
AL$$RAJ>LP 
APPENDJ>MA 
APSFXIPLP 

A11EA_>1ANJ>LP 

ASTRSKIPLP 

ATCH_JPUP 

BIN$SRJ>LP 

BINARY_J>LP 

CACHE_POPJ>LP 

CACHE_PUSHJ>LP 

CH$FX1J>MA 

CH$0C2J»MA 

C3IANGE_PWJLP 

CKDYNIPLP 

CUGETJLP 

CL$GET_EVJLP 

CL$PARJ»LP 

CUPDLPLP 

CL$SET_EVJ>LP 

CLOSE_J»LP 

CLOS_ALLJ>LP 

CLRLV_J>LP 

CMD_ 

POST_INVKPLP 

PRE_INVKJ>LP 

CNAME_J>LP 

CNINtPLP 



Interludes to old style calls 

This is the internal command for abbreviations. 

This is the routine to handle file I/O for abbreviations 

Get next whole token from command line, processing 

abbreviations. 

This is the routine to expand abbievi. 

Modifies the oontmts of an existing ACL 

Set ACL on one file to be like that on another. 

Parse an access control list. 

Process the add remote id e^wnm^n rf. 

Allocate space in process class storage for return function 

data. 

ALLOCATE STORAGE ON THE STACK CFREE ONLY BY PRTN). 

Allocate space and set return data for return function. 

APPEND — CONCATENTATE TO VARING STRING 

Append a suffix onto a pathname according to file naming 

standards 

This is a general PL/I Area Manager. 

Command 

Invoke the ATTCH command from ring3. 

Do a binary search using pointers in a single segment. 

BINARY Command. 

POP an entry from the per-level stack of program EPFs. 

POP an entry from the per-level stack of program EPFs. 

CHARA CTER TO FIXED BIN (15. 0) AND FIXED BIN (31, 0) CONVERT 

CHARACTER (OCTAL) TO FIXED BIN (31, 0) CONVERTER. 

Command to allow a user to change his/her login password 

Check the existence of a Dynamic Entrypoint 

Gets A Command Line Into User's Buffer 

Command Loop GET Entry Variable. 

Parse string according to basic "command line** rules. 

Parse command line according to a picture specifier. 

Command Loop SET Entry Variable. 

Check cmdl sjmtax and call SRCH$$ to close file units. 

Closes All Of A User's Open File Units. 

Qear the existing leveL 



CNSIG$J»LP 
COMANLJ>LP 
OOMLVIPLP 
OOMOSJLP 



Routine to perform post-program invocation initialization 

Routine to perform pre-program invocation initialization. 

Invoke the CNAME command from RING3-.Via GATE CNAM$$. 

Reads A Specified Number Of Characters From Cbmmand Input 

Device 

Set continue sw on in most recent fault frame. 

Writearound To CLSOET. 

Call a new command leveL 

OOMOUTPUT Command. 
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COND_CAIX&PMA ADDITIONAL ENTRY POINTS FOR THE CONDITION MECHANISM. 
CP$JLP Invoke the user's currently specified command processor. 

CP_rrERJ*LP Command langviage iteration, •wildcard, treewalt, eqname 

processor 
CRAWL_i>LP Perform a "crawlouf from an inner ring, and rejoin signl 

fim . 

CREATE__J>LP Process the CREATE (directory) command. 

CRFIN_J>MA CRAWLOUT "FAULT INTERCEPTOR" TO REINVOKE SIGNU IN THE OUT 

RING. 
DBSMODPLP Set/Reset debugger-mode switch and static on-iinit 
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DBG__J»LP 

DOOD_JTRJ>LP 

DEF_GVJ>U> 

DELAY_J»LP 

DELETE_VA1U>LP 

DELSEG_J»LP 

DEItGETJLP 

DF_UNrr_J»LP 

DUMPS_J>LP 

EDIT__ACX:_J>LP 

EDrr_CLJ>MA 

EUGTS_J»LP 

ENDPAGE_J>LP 

DF_UNrr_) 

EPFJALLCPLP 

EPF$CPFJ>LP 

gFS DEULP 

EPF$INFOJ»LP 

EPF$INrrJ>LP 

EPFJINVKJ'LP 

EPF$MAPJ>LP 

EPFJRELCPLP 

EPFSRELCPMA 

EPFSRUNJLP 

EPF_£RRJ>LP 

EPF_NWJ>LP 

EPF_NWAJ>LP 

EPF_RLJ>LP 

EPF__RLAJ»LP 

EPF_SRaLPLP 

EQUAL$J>LP 
EQUAL$J>LP 
ERRSETJMA 
EXSCLRJPLP 






EXSRDJLP 



bitental o^nmand writsaround tc ths DBG sztc 

Decode command langixage extended feature token type. 

Command to define global variables file to command env. 

Invoke the DELAY command from lingS. 

Delete global variables 

Process the DELSEG command. 

Get msg from a diagnostic Error Table. 

System Standard Default Qn-Unit Ondudes FL/I nmtime 

support). 

Dump stack in a pretty format 

Process the edit access command. 

EDIT COMMAND LINE TO REMOVE EXPUCIT NULL STRINGS. 

Set the scheduler variable EUGTS. 

PL/I runtime support for ENDPAGE condition (called from 

EPF linkage allocation routine. 

Get command processor flags from an epf . 

Terminate an epf invocation. 

Return info about a desired epf file. 

EPF static dau initialization routine. 

Routine to start the execution of an EPF. 

Routine which maps an EPF file to virtual memory. 

EPF Relative Pbinter relocation routine. 

Relocate EPF relitive pointers. 

Run an EPF : Executable Program Format file 

Routine to print diagnostic error messages to a user's 

Push volatile EPF smt data for program and library EPFs. 

Push volatile EPF smt data for ALL program and library E 

Pop volatile EPF smt data for program and library EPFs. 

Pop volatile EPF smt data for program and library EPFs. 

This routine searches an EPF library to resolve a faulte 

entrypoint. 

Generate name from an object (source) name and a pattern 

Append pathname generated from equalname to a given stri 

ERRSET INTERLUDE FOR SEGMENTED 

Disable the signalling of the EXITS condition upon progr 

termination. 

Return the value of the TRANSMIT EXIT command environment 
counter. 
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EXSSErJ>LP 

EXITJ»LP 

FATAUPMA 

FILLUJTN 

FIND$BKTJ>LP 

FINDPROCPMA 

FIND_£PF&PLP 

FIND_UIDJPLP 

FNCHKIPMA 

FNDCF$J*LP 

FNDLOWJLP 

FNONUIPLP 

FRE$RAJ>LP 

GATESJ>MA 

GEr_EPF_ 

PATHNAMEJ>LP 

GET_FRJ>MA 

GS__FACPMA 

GTSPAILPLP 

OVSGETJLP 

GVJSETJPLP 

G_FACVALJ>LP 

HASH UIDJ>LP 

ISGCLKPLP 

ICE$JLP 

IC3^rrB_J»\4A 

IDCHKIPLP 

INFIM_J>MA 

INIT$3J*LP 

INmPJLP 

INPUT$J>LP 

INTCM_J»LP 

INVKSM_J»LP 

IOA$J»MA 

lOAFMtFTN 

IOAGA$J>MA 

IOAGD$J>MA 

IS$EPFUSJ>LP 

ISF_EPFJ>LP 
IS_EPFEXJ>LP 



Enable the signallmg of the EXITS condition upon program 

termination. 

Exit from Static Mode, and return to Recursive Mode. 

GENERATE FATAL PROCESS ERROR. 

FILL ARRAY WITH LITERAL 

Search a PRIMOS standard hash table for a bucket address 

FIND NAME AND ADDR FOR DF UNIT PL/I CONDITION MESSAGES 

Routine to generate lists of epfs for a process. 

Bnd a <user id> in a validation file. 

Check the string passed for validity as a file system na 

Find most recent condition frame. 

Finds lowest timer of either type. 

Find onunit in specified stack frame. 

De-allocate space xised for return information for command 

functions. 

GATES toble. 

Routine to retrieve the full pathname of EPF. 

Get the field address registers and floating point regi 

GET/SET FLOATING ACCUMULATOR FROM A FAULT FRAME REGISTER 

Parse string according to four t3rpes of characters. 

Get the value of a global variable 

Set the value of a global variable 

Procedure to get the valxie of an offending fac 

Hash a <user id>. 

Get CLDATA£Xrr LB and CLDATA.EXIT SB for INFORMATION S 

Tnitiiiliyo. Command Environment 

INTERNAL (OLD AND NEW) COMMAND TABLE 

Check a (xiser or projert) id for legality. 

CRAWLOUT "FAULT INTERCEPTOR" FOR INTTSS dNITIALIZE RIN 

ENVIRONMENT). 

Tnitiiiiiw. the ring 3 environment, and make sure that t 

Ertemal Login is run 

Invoke initial routine (oominput, CPL, EPF, etc.) at lo 

INPUT Command. 

Fetch local command table entry if any, else check system 

table. 

Invoke (or restore) static mode program image. 

INTERLUDE TO CALL THE IOA$ FORMATTER. (IOA$, IOA$RS, 10 

FORMATTING PACKAGE FOR lOAl 

IOAGA$- GET ARGUMENT ROUTINE FOR lOAFMS. PRIM0S4 08/08/77 

This module does an unsigned long divide. 

Routine to determine if a given file is an EPF which is 

use. ^ 

Determine if my grandfather is an EPF or a static-mode 
Routine to check the existanoe of an EPF run file and op 
an EPF. 
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IS_EPFMPJ>LP 

IS_EPFSGJ»LP 

file in memory. 

mCWLDCPLP 

ITR_WLDTJ>LP 

KTRANIPMA 

LIBTBLJ>MA 

LIST$CMDJ>LP 



LIST$ENJ>LP 

EPF. 

LISTEN_J>LP 

LIST_AOC_J»LP 

LIST_J^CLJ>LP 

LICT_CMDJ>LP 



Routine to determine if an epf file is mapped to memory. 
Perform a mapping between a list of segment numbers and 

Perform command language Wildcard Iteration. 

Perform command language Treewalk Iteration. 

PERFORM A KEY TRANSFORMATION ON AN ENTRY POINT NAME. 

LIBRARY TABLES. 

List to terminal ring3, internal mini-level commands 

specified by input arguments. 

This routine returns all the library entrynames in a lib 



Primos command loop standard listener module. 
Process the list access command. 
Print the contents of an ACL on the terminaL 
list out the current mini-level internal commands and 
what their options are. 

Displays a list of entry names within a library EPF. 
This displays information about EPFs. 
List the user's active and/or inactive groups. 
Routine to retrieve and print EPF related data from user 
profile. 

Process the List priority access command. 
Process the LIST QUOTA command. 
List one or all ID's used by this user on remote nodes. 
LIST_SEGM£NTJ*LPTbJs routine parses command, prints the segments in user 
private, dynamic and static address spaces which are in 
Command to Print Search listCs). 
List global varialbes and their values. 
Process an EPF library search rule to resolve a faulted 
reference. 

Open the dyniunic linking search list for a process. 
Determine whether an attempted dynamic link is valid. 
Search djrnamic linking name space in order to resolve 



UST_ENJLP 
LIST_^FJ»LP 
LIST_GROUPJLP 
LIST_LIMJ>LP 

LIST_PA_J»LP 
LIST_QUOTAJ>LP 
LIST_REMID JLP 



LIST__SRLJ»LP 

LIST_VARJ>LP 

LN_EPFJ»LP 



LN_ISRJ>LP 

LN_XEGJ>LP 

LN_SLIBJ»LP 

entrypoint 

LN_STATJ>MA 



LOGOUT_J>LP 
LONSCNJLP 
LON$PRJ>LP 
LON_JU> 



Search shared, static-mode library list to resolve fault 

reference. 

Logout command processor. 

Perform Logout Notification control through SW$INT. 

Print phantom logout notification message 

Logout Notification Command 
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MAKE_UCTJ>LP 


Makes a sorted linked list from the passed list. 


MAXSCH_J>LP 


Set the scheduler variable MAXSCH. 


MF.S,SAG_J>LP 


Interface for the message facility 


MIN$CPJ>LP 


Mini-level Command Processor 


MTSSTNJ>MA 


HANDLE MISSING ARGS IN V-MODE 


MKONSF J>LP . 


Fortrui Interface CPCL call) to make an on-unit in calle 




frame. 


MKONUtPMA 


MAKE AN ON-UNIT IN THE CALLER'S STACK FRAME. 


MKSONIPLP 


Make a static on-unit for either ring. 


MOVWD&PMA 


DATA MOVEMENT SUBROUTINES. 


NEWLVIPLP 


Module to create a new level within the command environment 


OCALLSFTN 


OLD PRIMOS SUBROUTINES CALLS 


ONDISPJ»LP 


Display onunit data in a specific frame. 


OPEN_J»LP 


GFES Command. 


OPN$$RJ»LP 


Open using Search List. 


OPN$SRSFJ>LP 


Open file using search rules and suffixes. 


ORIGIN_J>LP 


Command to return to initial attach point. 


P$EPAGEJ>LP 


Write end of page text to a PL/I file for PL/I runtime 




support 


P$EXCPrJ>LP 


PLl Condition Exception Handler. 


WKEYJMA 


PL/I ONKEY BUILTIN FUNCIION 


PASSWD_J»LP 


Set owner/non-owner passwords for current password direc 


PHAN1X)M_J»LP 


PHANTOM Command. 


PL1$NI-PLP 


Nonlocal goto processor for PL/I (and any other 




block-structured language). 


PMtPLP 


Post Mortem command. 


PRERR_J*LP 


PRERR Command 


PREVSB_J>LP 


Find previous stack frame, given ptr to current. 


PRTN_J>MA 


VARIOUS FLAVOURS OF "RETURN" FOR USE BY THE UNWIND ROUT 


PWCHKIPLP 


Check a password for legality. 


R3ENTSJ>MA 


R3ENTS table. 


R3FALTJ>MA 


RING 3 FAULT CATCHER. 


RAISE .PLP 


Search the stack for an onunit for a specific condition, 


invoke it. 




RD$CE_DPJ>LP 


Return to the caller the current depth of the command env. 




program session. 


rdtkw.pt P 


Writearound to rdtk$p for use by static mode programs. 


RDTKSPJTN 


READ NEXT TOKEN FROM COMMAND LINE 
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RDTKNtFTN 

RDY_J>LP 

READYIPLP 

REENT_J»LP 

REMEPFSJPLP 

REMEPF_J>LP 

REM_PA_J>LP 

REM_REMID_JPLP 

RESTO_J»LP 

RESU$$JiMA 

RING3JjOAD 

WNG3__ENTRY_ 

TABLE_JIASH 

RLSLV$JPLP 

RLSTTL-JT-P 

RMODE_J»LP 

RPLIPLP 

RPL$CNJ>LP 

RSTERMPLP 

RVONUIPLP 

RVSON$J>LP 

SAL_HEAPJ>LP 

SAL_ISEGJ'LP 

SAL__LEVELJ>LP 

SAL_PROCPLP 

SAL_USERJ>LP 

SAL_VRFYJ>LP 

SAVEIPLP 

SCITJ>MA 



USER 



v^Au-ABus EiNiKi FOk k1/11C$$ 1,1 11 n STYLE) 
Set user's lesdy message modeCs). 
Print the ready (or error or warning) message. 
Signal the condition REENTERS for subsystem reentry. 
Delete (Remove) An EPF From A User's Address Space 
Remove An EPF From A User's Address Space 
Process the Remove priority access command. 
Process the REMOVE REMOTE ID command. 
Internal command "restore": load memory image of SM pr 
WRTTEAROUND FOR RESU$$ CALL. 
RING THREE LOAD DATA FILE 



All-rings direct call entrypoint definitions. 

Module to restore a level within the command 

Generate the Listener Order "release stack". 

Return into Static Mode program, as defined by an 

Routine to replace One File With Another File. 

Change the name of an open epf file. 

Command interface to reset terminal I/O buffer(s). 

Revert an onunit in caller's or given activation. 

Remove static on-unit. 

Heap Storage Allocator. 

Initialize A New Segment For Storage Allocation 

Program Class Storage Allocator 

Process Class Storage Allocator 

USER Program Class Storage Allocator 

Verifies Storage Class Key 

Save a portion of memory as a file. 

Storage Class Information Table 
SEARCH_CASELESS_ 
HASH_TABLE$ J>LP Caselessly search a PRIMOS standard hash 

table. 
SEARCH>J1A5H_ 
TABLEIPLP 
SETRCIPLP 
SETREGJ>MA 
SET_AOC_J>LP 
SET_PA_J>LP 
SET_QUOTAJ»LP 
SET_SRLHJ> 
SEr_VARJ>LP 
SFR__CFSCPLP 
SFR_JIEAPJ>LP 
SHLJLEVLPLP 
SFR_PROCPLP 
SFIL-USERJ»LP 
SHUTDN_J»LP 
SIGNLIPLP 
SMT_QADJ>LP 



environment 



"rvec 



Search a PRIMOS standard hash table. 

Set Static Mode error code. 

SETREG. GETREG - SET, RETRIEVE REGS IN SVEC 

Process the set access oonunand. 

Process the Set priority access command. 

Command to change quota or create a quota directory. 

Command to Set Search List. 

Internal command equivalent of &set var CPL directive 

Completely Free Storage Class 

Heap Storage Deallocator. 

Frees Space From level Class Storage 

Frees Space From Process Claas Storage 

Frees Space From User Program dass Storage 

Process the SHUTDN command. 

Signal a specific condition. 

Thread an entry to the head of the per-process queue of 

EPFs. 
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SMT_QFRJ>LP 

SNAP$3J>MA 

S0R31PLP 

S0UR3_J>LP 

SR$ADDBJ>LP 

SMOOPYLPLP 

SRSaiEATJLP 

SRSDELJ>LP 

SR$FINDRJ>LP 

SR$FR_1APLP 

SR$HEADPJ>LP 

SRSUSTfLP 

SR$NEXTIU>LP 

SRSOPENJLP 

SR$PARSEJ>LP 

SR$READJ>LP 

SR$R£MJ>LP 

SRJSETLPLP 

SR$TEMPLJ»LP 

SR$UPDTJ>LP 

SRSFXIPLP 

SRVEC_J>LP 

SSSERILPLP 

START__J>LP 

STD$C3>J>LP 

STK__EXJ»LP 

STR$ALJ»LP 

TRJASJLO 

STR$FRJ»LP 

STRSFSJLP 

SWFIM_J>MA 

TALOCPLP 

TEMP$AJTTI 

TEXTO$J»LP 

TIME_JPLP 

TM$ABSJ>LP 

TMSASSJLP 

TMSONUJLP 

TM$RDJ>LP 

TMSRL&FLP 

TM$SErJ*LP 

TOCHiaPLP 

TSRCSIFTN 

TYPEKJ 

UNWIND_J>LP 

USERSIPLP 

VIJSTJMA 

WILD$J>LP 

XISJ>MA 



Unthread an entry from the smt list for active EPSs. 

Snap link to a ring three (all-ring callable). 

Invoke ring 3 static on-unit 

Find static on-unit list for ring 3. 

Add a search rule to a list before an existing rule. 

Copy all locator values from old list to same rules in new 

list. 

Create search list specified by name and "open" it. 

Delete search list specified by name. 

Find a specific rule in a given search list 

Return to free pool the storage used by a search list. 

Get/Set Search List Head Pointer for this process. 

Return a list q£ all search list names in this process. 

Fetch the next search rule from a given search list. 

Find a search list spedfied by name and "open" it 

Parse a string search rule into a type and a text 

Return a list of all search niles of a given search list printable. 

Remove a search rule from a list 

Set the locator value in a given search rule. 

Process a search list template file. 

Install (update) a new copy of a possibly existing search list 

Perform tree search, with or without suffix standard. 

Set Static Mode "rvec" from a fault frame. 

Used by subsystems to declare that they have run into an 

Internal command "start": restart recursive or static mo 

Standard Command Processor. 

Handle auto static extension. 

Interlude To User Program Class Storage Allocator 

Subsystem Process Class Storage Allocator 

Interlude to User Program Class Storage DeaUocator 

Frees Space From Subsystem Process Class Storage 

Ring 3 QUIT FIM-Invoke QUIT Condition In Ring 3. 

Allocate large storage area 

OPEN UNIQUE TEMPORARY FILE ON CURRENT UFD 

Check a character string for validity as a filename. 

Process the TIME command. 

Sets timer for time of day. 

Assigns virtual timers. 

Virtual timer static on unit 

Reads time remaining on virtual timers. 

Releases an assigned timer. 

Sets virtual timers. 

Checks a character string for being a legal treename. 

OPENS FILE WITH SPECIFIED TREENAME 

lype text at a user's terminaL 

Prepare the stack for nonlocal-goto-induced unwinding. 

USERS Command 

VLIST 

Match wildcard name. 

XIS UNIMPLEMENTED INSTRUCTION EMULATOR 
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AFTEFL-AFJ>LP 

ALLOC_VAILPLP 

ATTOB_AFJ>LP 

BEFORE_AFJ>LP 

CALOPLP 

CH$HZ2J>MA 

CND_INFO_AFJ>LP 

OOM_ABRVJ»LP 

CPLPLP 

CPL_J»LP 

CPL_JEr_J>LP 

CVSDQSJLP 

\CVDTRPLP 

CV$FDAJ>LP 

CV$QSDJ>LP 

DATE^JU^JLP 

DIWLSJLP 

DIR$SEJ>LP 

DIRSERJ>LP 

DIR_AFJ>LP 

ENTRY__AFJ>LP 

EVAL_ 

AFJLP 

AN_EXPRJ>LP 



'after* active function for CPL. 

Allocate an extension area for variables 

Get certain file attributes (oonunand function). 

•before* active function for C3»L> 

Evaluate arithmetic and logical expressions for CPL. 

CHARACTER (HEX) TO FIXED BIN(31^) CONVERTER. 

condition info a/j retrieve selection oond. infa 

Interlude to invoke command abbreviation processor. 

Interface CPL interpreter to command leveL 

Command Procedure Language Interpreter. 

Return pointer to CPL Error Table pathname. 

Convert FS format date/time to quadseoonds since Jan. 1, 

Convert Date from ASCQ to Binary Cfile system) format. 

Standard fs date-time-mod converted to format mm/dd/yy 

dow 

Convert quadseconds since January 1, 1901 to date. 

Date Command (Function). 

Write-around to the routine DIR$SE 

Retrieve info about selected entries in a given directory 

Remote interlude to DIRSSE. 

'dir' active function for CPL. 

'entry* active function for CPL. 



EXT_VBLJ>LP 

EXISTS_AFJ>LP 

EXTR$AJ>LP 

EXT_ 

VBL_MANJ>LP 

FROM_DECPLP 

GET_JEXPRJ>LP 

GEr_LINEJ>LP 

GEr_REPLYJ>LP 

GEr_TOKENJ>LP 

GET_VAR_AFJ>LP 

GVPATH_AFJ>LP 

GV_PRT_JPLP 

HEX__AFJ>LP 

ICPL_J»LP 

ID_CHECKJ»LP 

INDEX_AFJ>LP 

LENGTH_AFJ>LP 

MOD_AFJ>LP 

NULL_AFJ>LP 

OCrAL_^AFJ>LP 



Active function evaluator for CPL. 

Evaluate an expression containing variable references and 

command functions 

Evaluate character string containing local/global variable 

refs. 

EXISTS command function for CPL. 

Extract pathname components. 

External Variable Manager for Primes Command Loop. 

Convert a decimal integer to an integer in a given base 

less than 17. 

Accumulate the next expression from the current line. 

Get a new logical line from file on ^1 unit 

Fetch a yes/no/nuU/neit reply from command input stream. 

Get next token from CPL program 

Get var command function for CPL. 

Retum pathname of current global variable file. 

Get pointer to global variable area. 

Convert hexadecimal integer to decimal integer 

Invoke CPL interpreter on given file, processing suffix. 

Check a given string to see if it is a valid command var 

identifier. 

Index' active function for CPL 

length* active function for CPL. 

Implement mod function for CPL. 

•nuU* active function for CPL. 

Convert octal integer to decimal integer 
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OPENSBJPLP Open a branch by tree name (nonstandard) 

OPEN_ 

FTT-F_A F-PT.P Open file command function for CPL. 

PATHN_AFJ?LP Pathname command f xmction for CPL. 

QUERY__AFJ*LP Query command function - get yes/no answer. 

QUOTE_J»LP Perform a quote operation on a given string. 

QUOTE_AFK-P Perform quote operation for CTL active function. 

READ_ 

FILE_JU'J>LP Read file command function for CPL. 

RESCAN_AFJ>LP Rescan command function for CPL. 

RESPONSE^AFJLP Response command function - get textual answer. 

SEARCH_AFJ>LP 'search' active fiinction for CPL. 

SET_A_VARJ'LP Set local and global user variables. 

SIZE$BJ>LP Return the size of a branch in WORDS. 

SUBSTR__AFJ>LP 'substr" active function for CPL. 

SUBST_J^J*LP Substitute conunand (function): substitute s3 for s2. 

TEST_EQUALSJ>LP Test expression equality for CPL. 

TO_HEX__AFJ»LP Convert a decimal integer to a hexadecimal integer. 

TO_OCr__AFJ>LP Convert a decimal integer to a octal integer. 

TRANSL_AFJ>LP 'translate' active function for CPL. 

TRIM_AFJ>LP "trim' active function for CPL. 

UNQUOTE_Jtf JLP Perform unquote active function for CPL. 

VBL_MANJ>LP Variable manager for subsystems allowing dynamacally 

allocated string vara. 
VERIFY_AFJPLP 'verify' active function for CPL. 
WILD_^AFJ>LP "Vild" command function - get list of files by wild 

name. 
WR_JILE_AFJ>LP Write file for CPL. 
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2^ NS-RQirnNES 



ALCADRJLP 

ALCHCaPLP 

ALCMYLJ>LP 

ALCNAMPLP 

ALCPDNJLP 

ALCPTAJLP 

ALCTTftPLP 

ALCRNGJ>LP 

ALCSLOPLP 

ALLOCPMA 

CALLrrjMA 

CALLS_JT. 

CFGSLCPLP 

CIRLOGJLP 

CKNDNMJLP 

CKSLIDJ'LP 

OOMDEFJMA 

EXTRACPLP 

FNSIDIPLP 

Find_AddrJ'lp 

Fmd_NameJ»lp 

Find_PDNJ>lp 

GETVCIXJ>LP 

GNUSRIPLP 

HDLCERJ>1JP 

ICSCCPLP 

ICSSAVJ>MA 

INIPNCPLP 

ISREM$J>LP 

LKFAfMA 

LKTAJMA 

MOVBJ>MA 

NUADRJlp 

N$AHCBJ>LP 

NUNAMPlp 

NUPDNJlp 

NSAFTHJlp 

NUSADJ>lp 

N$INITJ>LP 

N$IPDNJ>lp 

N$LALLJ>LP 

N$LCFGJ>LP 



Allocate and initialize (to all zeros) an address entry. 

Allocate and initialize (to all zeros) a host control block. 

Allocate and initialize my node's line definition table entry. 

Allocate and initialize (to all zeros) a name table entry. 

Allocate and initialize (to all zeros) a PDN control block. 

Allocate and initialize (to all zeros) a KHUce iddreas cha 
link. 

Allocate and initialize (to all zeros) a path control block. 

Allocate and initialize a ring line definition table entry. 

Allocate and initialize an SMLC line definition table entry. 

ALLCXIATES SPACE FOR TEMPS ON THE FLY FOR SLAVES 

GIVEN A PCL NAME AND ITS ARGS, THIS SUBR MAKES THE DYNT A 

Configure an SMLC line definition table entry. 

STUFFS CIRCULAR BUFFER FOR DEBUG OF NPX 

Subroutine to check the validity of node name on the name 

table. 

Subroutine to check the validity of the SLAVID. 

Network common definitions 

EXTRACTS A SPEOHC SPARE DATA FIELD FROM A REQ OR RESP 

MESSAGE 

Search the DIFNS id structure for the id for a given node. 

Look for an addr block in the network databases. 

Look for a name block in the network databases. 

Look for a pdn block in the network databases. 

GETS AN INDEX INTO THE VCDATA FOR THIS USER 

Gets the network process' user number. 

REPORT INTERNAL ERROR IN NETWORK SYNC SOFTWARE AND 

DISABLE LINE. 

Routine to process ICSl code works and control block receive 

by X.25 level n. 

Buffers for ICSl interrupt status and counters. 

Tn i ti «1i7<t the Ring's cold start timer and line def timers 

Return information on remoteness of a filesystem object 

LOCKFA 

LOCKTA 

MOVES N BYTES FROM SRC 32 BIT POINTER TO DST POINTER 

Add a node "addr block" to the network database. 

Add an HCB block and a linedef block to the database. 

Add a node "name block" to the network database. 

Add a "pdn block" to the network database. 

Add a "path block" to the network database. 

Add an address to a source ^dress c^ n in 

Initialize aU the network databases. 

Fill the PDN table with known pdn values. 

GATHERS STATISTICS FOR ALL PRIMENET SYNCHRONOUS LINES. 

GATHERS CONHGURATION STATISTICS FOR ONE PRIMENET 

SYN(3IR0N0US LINE. 
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N$LDYNJ>LP 
N$LOGO=FTN 

NSNETSJLP 

NJRTRCPLP 

N$RTRCJ>LP 

mSPMRPlp 

NSVALLPLP 

NSVONEPLP 

NBKDEFJ>MA 

NBKINLFrN 

NCMSUBJPTN 

NETABTJTN 

NETCMIFTN 

NErDMPJ>MA 

NETDWNJLP 
NETEVIJMA 
NErEV2JTN 
NETFIGJ*LP 

NErMAPJ>LP 
NETPRCPLP 
NErRTNJ*LP 
NETSETJLP 

NETSGSfMA 

NErUTUJ>LP 

NICSOFJLP 

NICSONJLP 

NNTTUSMA 

NPXJIULPLP 

NPX$SLJ>LP 

NPXDNTJMA 

NPXONJPLP 

NPXPRCFTN 

NSLOOFPTN 

NSLOONJTN 

NSLDNJ>LP 

NSLCTPJTLP 

NSLSnLPLP 

NSLUPJ>LP 

NTINrrJTN 

NTWMABJ>LP 

PDNDEFJ>MA 

PNCDIMJMA 



GATHERS DYNAMIC STATICS FOR ONE PRIMENET SYNCHRONOUS LINE 
TELL NETWOBJC TO SESD FORCED LOGOUT MESSAGE TO REMOTE 
USER PROCESS 

Do final network oonf iguration and setup. 
ROUTINE TO GATHER PNC STATICS DATA. 
Turn network ting tracing on/off. 

Add all the "myself spedfic" data to the network database. 
GATHERS DATA FOR ALL VIRTUAL ORCUrrS 
GATHERS STATISTICS FOR ONE VIRTUAL QRCUIT 
NETWORK NEW BLOCK AND QUEUE DEFINITIONS 
ROUTINE TO INITIALIZE NETWORK BLOCKS AND QUEUES 
Initiates a HDX Primenet link. 
Main "work" loop for network process. 
Handles "NET commands for HDX operator interface. 
USED TO TRACE ILLOGICAL SYST1EM FAILURES DURING PRIMOS 
OPERATION. 
Shuts down networks. 

FIRST-LEVEL EVENT LOGGER (PCL-ABLE VERSION). 
SECOND-LEVEL EVENT LOGGER 

Building ring new-network-oonfigurator databases from old 
NETCFG 

Subroutine to manage segment mapping for networks. 
NETWORK PROCESS RUNNING IN RING 
Subroutine to invalidate network cache on RTNSEG 
Checks authorization of user starting network and init network 
segments. 

COMMON DEFINmON FOR NETWORK MAPPED DATA MOVEMENT SUB- 
ROUTINE. 

Subroutine to copy from Networks to user space. 
Deconf igure an ICS network line. 
Configure an ICS network line. 

ALL THATS LEFT HERE IS A HALD (FOR FORTRAN STOPS). 
CALLED BY SLAVE CK TO RETRIEVE THE ENTRY POINT OF ANY 
HANDLER. 

CALLED BY SLAVE TO SOTRE ITS ANY HANDLER IN RING 
DATA BASE. 

NPXDNT - THE DYNT TO GET NPXPRC DEFINED FOR RSCALL. 
Start up NPX slaves. 

THE RING CALLS TO SUPPORT NPX (ANALOGOUS TO FAMSVC, 
FAMPRX 

Subroutine to turn off a network synchronous line. 
Subroutine to configure a network MDLC line. 
BRING ALL RUNNING NETWORK LINKS DOWN. 
STOP A SYNCHRONOUS LINE FOR PRIMENET. 
START UP A SYNC LINE FOR PRIMENET. 

START UP ALL OONHGURED SYNCHRONOUS NETWORK LINKS, 
initialize the network. 

Warm start code executed by the network process. 
BLOCK DATA FOR DEFAULT PDN TABLE DEFINmONS 
HARDWARE INTERFACE FOR PRIMENET NODE CONTROLLER 
CFORMERLLY FARNET). 
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PRFThOLPLP 

PRHDLCPLP 

PRHLOGJTN 

PROALMPMA 

R$AL01J>LP 

RJALOOPLP 

R$BGINJ>LP 

R$CALLJ»LP 

R$CKNTJ>LP 
RSCXVCFLP 

RSENDfLP 

RSMYNMPLP 
RSNAMEPLP 
WNODNJLP 

RSRLSJ>LP 

RJSLEDPLP 

WSYSNJLP 
RLOGINJTN 

RNGRCVJ»LP 
RNGSNDJ>LP 
SLAVEPLP 

SLAVERJ>LP 

SLAVE_CICPLP 

SLCNETJMA 

SLCNSBPTN 

SLCPULPLP 

STOPME. FTN 

SrrPNGPLP 

STRBLPLP 

TICKL2J'LP 
TRNRCVJLP 



Timer routine for Level n Protocol for Ring Network. 

Routine to implement X2S Level ProtocaL 

Subroutine to enter data into NETREC 

Indicate protocol required and notify network lerver process 

This routine increment the ALOCNT by 1. 

ALLOCATES A VOX SLOT FOR NODB-XRNODE-JF THE SLOT EXISTS 

INC31EMENTS AN ALLOCATION COUNT. 

The user callable interface to NPX for lyndinmoua and 

asynchronousRECALL. 

THE USER CALLABUE INTERFACE TO NPX TO MAKE REMOTE 

PROCEDURE CALLS 

Subroutine to check the validity of the lupplied node name. 

CALLED BY LOGABT TO CHECK NPX VIRTUAL CIRCUIT, IF ACTIVE. 

CLEAR IT. 

The Asynchronous Remote Procedure Call-eND, check slave's 

task. 

Return name of local node. 

Convert node number to node name. 

Add systemnamc to the node name uble (NDNTBL) and return 

pointer. 

Decrements a pemode allocation count for NPX, if count r 

the slave is released. 

Subroutine to convert node name to slave id if the VC is 

secured. 

Subroutine to return the system name for a given SLAVID. 

CONTROL USER PROCESS ON TERMINAL SIDE OF REMOTE LOGIN (MOS 

IDLE). 

Level n protocol receive for Ring Network. 

Level n protocol transmit logic for Ring Network. 

GIVEN A REQL'EST MESSAGE IN BUF, SLAVE CALLS THE TARGET SUB 

SENDS A RESPONSE 

THE ROOT TO ALL SLAVE INVOKATIONS-ACCEPTS CALL & DEFINES 

FIRST MSG BUFFER. 

It is called by DF UNIT to check the usr type, if UJNPX ge 

SLAVE ON UNIT. 

SMLC INTERRUPT SATUS HANDLER FOR X.25 LEVEL 2. 

SUBROUTINES FOR PRHDLC TO SLCNET INTERFACE 

Call PRHDLC when a queue has something to process. 

PRINTS ERROR AND STOPS NPX PHANTOM. 

ROUTINE TO GATHER PNC STATISTICS DATA. 

R OUTIN E TO MOVE THE RING BREAK INFORMATION TO A RING 3 

BUFFER 

Tick off level 2 docks. 

TRANSMITS AND RECEIVES MESSAGES TO AND FROM SLAVES IN ONE 

OPERATION UNDER QUTTPROTECnON. 
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UPUSIJLP 

UPUS2JLP 

UPUS3JLP 

User_VaUdJ>lp 

VONFOJU 

X$ADa-PLP 

XJADRTTN 

XSASGNJLP 

X$BIDJ>LP 

XSBRLGPrN 

XSBVCRPLP 

X$CAC3>JTN 

XSOjOKJTN 

X$CLRAJnrN 

X$CNFGJ>LP 

XSOOPYJTN 

XJCREQJTN 

X$DDCLPLP 

X$DIAGJ>LP 

XSFCNFJTN 

xjfcty.plp 

X$FLDSJTN 

X$GBCDJTN 

XJGErUJTN 

X$GIVUJTN 

XJGWCFTN 

XJHDOWPTN 

X$HDWNJ*LP 

X$IDNTPrN 

X$IPKTPrN 

XfiJNKJPTN 

X$LINKJ>LP 

XiLOOPPTN 

X$MAPJ>MA 

XSNORMFTN 

XJNTEnfPTN 

XSPKDAFTN 

XSRLGJTN 

XiRLTJTN 

X$RSETJTN 

XiRTiTJ* 

X$RTLPLP 

X$SRNILFTN 



Subroutine to update user status words. 

Subroutine to update user statxis words. 

Subroutine to update xiser status words. 

Validate the network initializing user 

Subroutine to check, the network status. 

Routine to add declaiatian to DCL list. 

Modules to decode addresses from incoming calls. 

Assign primitive for general usera. 

Routine to build a restart ID packet (rev 20+X 

Associate an incoming remote login call request with a user 

Bind an incoming call request to a declaration block and a 

ROUTINE TO ACCEPT A CALL. 

BACKGROUND CLOCK FOR LEVEL 3 X.25 - SHOULD RUN EVERY 10 

SECONDS. 

ROUTINE THAT CAN BE USED TO CLEAR ALL CONNECnONS A USER 

OWNS 

Return pointers to various conHguration related objects. 

ROUTINE TO COPY PACKET INTO AN UNWIRED BUFFER. 

PROCESS AN INCOMING CALL REQUEST. 

Remove declaration from list. 

Handling of level 3 diagnostic packets. 

Fortran callable version of configuration data lookup routine. 

Facilities parsing for call request/incoming call packets. 

XSFLDS - Get all of the fields in a CREQ, ACCEPT, or CLEAR p 

XSGBCD - ROUTINE TO COPY BCD DIGIT STRING TO ASCn STRINGS 

ROUTINE TO HANDLE OUTPUT PACKEITZING 

XSGIVU - ROUTINE TO TRY TO GIVE DATA PACKETS TO USER LEVEL 

PASS CONTROL OF A VIRTUAL CIRCUIT TO ANOTHER USER 

ROUTINE TO SHUTDOWN X.25 LEVEL 3 FOR A GIVEN HOST 

Clears all virtual circuits to the specified host 

Routine to build a restart ID packet (rev 173+) 

TAKE INCOMING PACKETS FROM LEVEL H PROTOCOLS 

Links network table entries together for HDX on-the-fly 

configuration 

Line network table entries together for HDX on-the-fly 

configuration 

ROUTINE TO PROCESS PKTS THAT START AND END IN THE SAME 

MACHINE. 

POINTERS TO IMPORTANT NETWORK STRUCTURES. 

DECODE CMND BYTE AND DO ROUTINE WINDOW UPDATES/CHECKS 

WAIT ON AND KICK USER'S NETWAIT SEMAPHORE 

NETWORK PRIMmVES 

HANDLE USER SIDE OF R^IOTE LOGIN 

LO-THRU MODULES - TERMINAL SIDE OF REMOTE LOGIN 

ALLOW A USER TO CAUSE A RESET ON ONE OF HIS VIRTUAL 

ciRCurrs. 

Ring support for route through configuration information 
Set up this process to run as the route-through server 
XJSRNR - ROUTINE TO SEND RNR ON A VIRTUAL CmCUIT 
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XSSTATJTN 

X$UASNJ>LP 

XSULNKJLP 

XJUSRQJTT^ 

XSUTILJTN 

X$VIDJ»LP 

XJVLNKJLP 

X2SDEFJ>\fA 

XLASGNJLP 

XLCSCSJTN 

XLUASNJLP 

XMTRCVJ»LP 



ROUTINE TO RETURN STATUS INFORMATION TO USBl SPACE 

Unassign primitive for general users 

Unlink the network table entries and put a tite 'offline' 

ROUTINE TO PUT VCB IN A USER'S QUEUE OF VCBS 

ALL OF THE NETWORK SOFTWARE UTILITY ROUTINES 

Routine to verify a restart ID packet (xtv 20f) 

Verifies that network table entries are linked together as 

expected 

X25 NETWORK COMMON DEFINmONS (UNWIRED) 

Extended declaration of interest in incosung atiin 

XLGCS - GET ALL OF THE FIELDS IN A CONNECT REQUEST PACKET 

Unassign an extended declaration 

Transmits and receives message to and from tlaves in one 

operation under quit protection. 
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2.6 RJES-ROUTINES 


DATC3»YJ>LP 


This routine copies data to the Trace Buffer I 


GETCPJLP 


PHAVRK - return pointer to area used to pass PH conf ig 


GR'1'SJ>LP 


Protocol specific handler for the GRTS protocoL 


GRl-SaCPLP 


GRTS Protocol Specific Check module 


HASPJ>LP 


HASP protocol specific RJPROC code 


HASPC3CPLP 


HASP Protocol Specific Check module 


PHDBGJLP 


PH - returns addresses of common area for protocol handler 


Teadqt.plp 


Routine reads entry off primos queue 


RJ$ATTJ>LP 


RJl interface routine - allows process to attach for lin 


RJ$LPLP 


RJI routines return information/data to the user from the 




protocol handler 


RJ$MSGJ>LP 


RJPROC message returning routine 


RJ$OJ>LP 


RJI routines will output blocks, control messages. 




detach (disable) line 


RJALQUJLP 


Create a queue and a queue control block given a chunk o 




memory 


RJCDFJ>MA 


COMMON DEO-ERATIONS FOR RJE EMULATORS 


RJCKPCPLP 


To valid the request protocol and character code 


RJCMITULP 


Configure MTR sub-process for protocol handler 


RJCTYJLP 


RJI-PH-routine copies zmit blocks into wired xmit buff 


RJDBGJ>LP 


Debug gate returns pointer to RJI common blocks for work 


RJDLINJ>LP 


Deconfigure line 


RJES_ 




VERSIONJ>MA 


List of RJES version numbers B 


RJEVNTJ»LP 


Event handler for the Rjproc system 


RJGBDQJLP 


RJI-PH routine - get a data block off a devide queue 


RJINLPLP 


Cold start code for RJE emulators 


RJUNEPLP 


Low level routines for Rjproc 


RJMNTTJPLP 


Ring code required to run the Monit facility 


RJPCnFJ>MA 


Protocol handler common declerations for rje emulators 


RJPHFSJLP 


rje emulators - routine manages the dim free store area 


rjphto.pl 


rje emulators - routine assigns a line control block 


RJPH&PLP 


RJI Ph routine - modify protocol handler state in the wo 




RJI daubase 


RJPLOJLP 


Logout code for protocol handlers 


RJPMSGJ>LP 


RJPROC message printing routine 


RJPRCXIPLP 


Main driver for RJE emulator process 


RJQJ»LP 


RJI queueing routines using ROCB 


RJRBRQPLP 


Protocol handler - copy contents of receive block and queue 




the worker 


RJRECVJ»LP 


Receive routines for RJPROC 


RJRQSTJ»LP 


Worker request processor for- RJPROC 


RJRTRYJLP 


Routines supporting RJPROC retry mechanism 


RJSOLFTN 


This program sets up DMC channels for a logical SMLC line 


RJSLCTOJ'LP 


Configure HSSMLC, MDLC and LYNX for RJE use 


RJTfttPLP 


Timer routines for the Rjproc system 


RJTWKRJ>LP 


Send Messages to Ring3 Workers via RJI 


RJUNDOJ>LP 


Logout code for RJE emulators. 


RJWLOJ>LP 


Logout code for RJI workers. 


RJWRF&PLP 


RJE emulators - routine manages RJI system free store 
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Tjxmitplp 

X80J>LP 

X80CXJLP 

XBMJLP 

XBMOCPLP 

XBMCOMJMA 



","' ' '"v^ oaaij 



XU AUU llllTlffffI' 



jjll. UJIUUUl UXUbJL 



line 

Transmit routines for RJPROC 

XSOprotoccl handler 

X80 Protocol Specific Check module 

XBM line events and timeouts 

Determine tjrpe of message from MTR (XBM Link level) 

processing 

ALLOCATE SPACE FOR XBM CAT QUEUES 
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2.7 SNAS-ROUTINES 



PRIMOSCX)MO_-E 

SNA$CPJTN 

SNASCXLFTN 

SNASIADMJLP 

SNAilANJLP 

SNA$ICLSJ>LP 

SNASIGDJ>LP 

SNASIOEPLP 

SNA$IOPNJ>LP 

SNASIRDJ>LP 

SNA$IR&PLP 

SNA$ISSJ>LP 

SNA$ISTJ>LP 

SNA$ISTAJ>LP 

SNA$ISTPJ>LP 

SNAJIWILPLP 

SNASPRPLP 

SNASECPLP 

SNA_GATESJ>M 

SNA_JCHKJ>LP 

SNA_JGErJ>LP 

SNA_JCCFCPLP 

SNA_JROJ»MA 

SNA_IRCVJLP 

SNA_JRLSJ>LP 

SNA_ISNDJ»LP 



Create the Free Storage classes for SNA Free Storage 

Create the Free Storage classes for PRIME/SNA RJE 

Administration Control Request Gate 

Create and send a START 3270 LECB to the LU Manager 

dose established Mate-Manager connection 

Build and send a GET DEVICE LECB to the LU Manager 

Retrieve a message for a LU Mate from the LU Manager 

Open connection between mate and manager 

Build and send a RETURN DEVICE LECB to the LU Manager 

Build and send a RECOVER SESSION LECB to the LU Manager 

Build and send a SUSPEND SESSION LECB to the LU Manager 

Build and send a CHECK STATUS LECB to the LU Manager 

Administration Status Request Gate 

Adminstration Stop Request Gate 

Build and send a WRITE DATA LECB to the LU Manager 

Create an SNA Service for an SNA Adminstrator 

Security Check for SNA gates 

Gated interludes to standard routines for Free Storage and 

IPQNM 

Do connection checks for' Gate routines 

Obtain a buffer from Mate free pool 

Set the specified Interlock 

PRIME/SNA Interactive Ring O Database. 

Obtain a request queued from the LU Manager 

Return a buffer to free pool 

Queue a request to the LU Manager 
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3 SYSTEM CSONFIGURATION INFORMATION 

1. PROCESS EXCHANGE MECHANISM - PXM 

• process control blocks (PCB's) 

• ready list 

• wait list 

MEMORY MANAGEMENT 

• descriptor table address registers (DTAR's) 

• tegment descriptor words CSDWs) 

• page maps (HMAFs. LMAFs. MMAFs) 

• ptuaeg 

• paging disk, map (PDMAP) 

FILE SYSTEM 

• locate buffers 

• unit ttbles (UTs) 

• unit table entries (UlFs) 

2. STACKS 

• interrupt stack (INTSK) 

• page fault stack (PGFSTK) 

• unwired ringO stack (SUPSTK) 

3. OTHER AREAS 

• user profile common (UPOOM) 

• per user data common (PUDCOM) 

• locks 

• disk queue blocks (DQB's) 

• supervisor common (SUPCOM) 

• user type array (UTYPE) 

• configuration common (FIGCOM) 

• register save area (RSAV) 
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PROCESS EXCHANGE MECHANISM - FXM 

4 PROCESS CONTROL BLOCKS - PCB s 

1. THE PXM IS MADE UP OF 3 MAIN ELEMENTS 

• PROCESS CONTROLL BLOCKS 

• READY LIST 

• WATT UST 

1. Used by both the software and the microcode. 

2. Contains all the essential information of all the processes on the S3rstem 

3. The PCB's are located in segment 4, location '600 - '640. 
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5 READY LIST 



1. The ready list is used by the micrcode to indicate priorities and dispatch processes. 



2. A series of PCB's actually make up the ready list as well as two 32 bit registers called 
H>A and PPB located in the microcode scratch area (PPA-pointer to process A and PPB- 
pointer to process B) 



3. The dispatcher (user -22) always runs the highest priority and can preempt any process. 
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6 WATT LIST 



1. The wait list specifies a group of processes that are waiting for an event to occur. The 
wait list is made up of 2 major elements: 

• a semaphore 

• a data base made up of PCB's 



2. Each process or linked lists of PCB's in the wait list, wait on a semaphore for the event 
to occur. 
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7 MEMORY MANAGEMENT 



• descriptor table address register (DTAlO 



• segment descriptor words (SDW) 



page maps (HMAPS, LMAPS, MMAPS) 



• ptuseg 



• paging disk map (PDMAP) 
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8 DESCRIPTOR TABLE ADDRESS REGISTER - DTAR 



1. There arc 2 DTAR's in each PCB 4 DTAR's in each register set 



2. contains the physical address of segment descriptor tables. 



3. Together with the SDTs and the hardware page maps the DTAR is used to help translate 
virmal to physical addresses in the STLB logic 
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9 SEGMENT DESCRIPTOR WORDS - SD W 



1. SDWs contains the physical address of the «art of the page toble f or a given segment. 



2. Must be wired. 



^' J^J^^^ ^°" ^^ ^ ""^ ^^ 3 *« ^^ ^ ^^^ ^^^ I»g« fault stack 



Cpgfstk), 
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10 PAGE MAPS (HMAPS. LMAPS, MMAP) 



1. The HMAPS and LMAPS contains the physical page number. 

2. Beginning with rev IW, PRIMOS supports different versions in order to support 16MB of 
physical memory for various type processors. 

3. The HMAPS and LMAPS are setup by the software and must be wired. 

4. The HMAPS and LMAPS are used by the software and the microcode. 

5. The MMAPS is a software only database which must be wired. 

6. The MMAPS contains one entry for each physical page whether they are in use or not. 
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11 PAGE TO USER SEGMENT (PTUSEG) 



1. One entry C2 words) for every segment in the system. 

2. Does not contain entries for "WINDOWED" segments. 

3. The initial VMFA segments are allocated at the end. 

4. PTUSEG can be found in segment 14. Each entry (2 words) will contain the user # and 
the segment #. Each time a user logs out, that particular segment for that user is 
available for use. 
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12 PAGING DISK MAP (PDMAP) 



1. Used to allocate records on the paging surface. 



2. Each bit represents 8 records on the paging disk. 



3. PDMAP can be found in segment 14. 
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1 a FILiE S VfiTFTM 



• LOCATE BUFFERS 



• UNIT TABLES (UTs) 



• UNIT TABLE ENTRIES (UTE's) 
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14 LOCATE BUFFERS 



1. Serves as a cache for disk access. 

2. Active, one per user is mapped to a buffer 

3. Each buffer has an associated buffer control block (BCB) IBCB/locate buffer, each BCB is 
wired. 

4. Locate buf errs are only wired when in transistion. a process can only own one locate 
buffer at a time. 

5. locate buffers can be found in FS>LOCATEPMA . 
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15 UNIT TABLES (UTs) 



1. A UT is a list of pointera to UNIT TABLE ENTRIES (UrFs). 



2. 1 UT per user. A maximum of 32768 units per user. 



3. G}ntains attach points and file units. 



4. Per user UTs are allocated and deallocated dynamically 
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16 UNIT TABLE ENTRIES (UTEs) 



1. A UTE dcsribes a file sjrstem object that is currently in use via the file system. 

2. One UTE exist per open file or attach point and contains all necessary fUe information. 

3. A type for each of the following: 

• attach points 

• local files 

• remote files 
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17 STANCE 



INTERRUPT STACK (INTSK) 



• PAGE FAULT STACK (PGFSTK) 



• UNWIRED RMGO STACK (SUPSTK) 
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18 INTERRUPT STACK (INTSK) 



1. The INTSK is located in segment 4. This is the only stack used for all interrupt processes. 

2. Contains the phantom interrupt code for all the controllers as well as the RSAV area for 
machine checks. 

3. For more information on the INTSK, refer to SEG4JMA and PRIMOS INTERNALS. 
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19 PAGE FAULT STACK (PGFSTK) 



1. This area is wired when a user logs in and is limited in nit. 

2. The page fault handler is locted in segment 6. 

3. The following fault handlers exist in segment 6: 

• process fault 

• page fault 

• UH 

• access violation 

• seoMiphores (overflow or underflow) 

• segment fault 

• pointer fault 

4. any other faults taken in ringO will take a halt instruction. 
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20 UNWIRED KINGO STACK (SUPSTK) 



1. The SUPSTK is only allocated 8 pages. 



2. The SUPSTK is located in segment 6003. 



3. The SUPSTK is the mcjst used stack by PRIMOS 
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21 OTHER SYSTEM INFORMATION 



1. USER PROFILE CX)MMON (UPCX)M) 

• UFCOM is located in segment 6000/16000 



2. PER USER DATA COMMON (PUDCX)M) 

• PUDCX)M is locsated in segment 6000/000000. 



3. SUPERVISOR COMMON (SUPOOM) 

• SUPCOM is located in segment 6/1400 



4. CONHGURATION COMMON (FIGOOM) 

• FIGCOM is located in segment 14/700 



5. REGISTER SAVE AREA (RSAV) 

• The RSAV area is located in segment 14/2000 - 14/3777. 
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22 LOCKS 



1. NILOCKS 



• multiple xeaden or 1 writer locks 

• Set of hierachical system locks 

• Prevents deadlocks (deadly embrace) and race conditions 

• Allows access to critical databases to only one process at a time (if writing) 



2. MUTUAL EXCLUSION LOCKS 

• Strewn over the entire S3rstem. 
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23 DISK QUEUE BLCX3KS 



• Database uaed to communicate information about disk requests between a user process and 
the disk interrupt process. 



• Each entry has multiplexed data. 



• The amount of disk queue blocks available depends on the revision of primcxs. 
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24 VAKIOUS CONFIGURATION INFORMATION 



1. MAXPAGE is located in segment 14. 

2. The ECCCt^ count is located in segment 4. This is where the memory ECCC errors are 
recorded. 

3. PAGEDEV is located in segment 14. 

4. ALTPAGEDEV is located in segment 14. 

5. VPDEV is located in segment 11. This is where the data partitions are kept from the 
addisk command. 

6. NUSR is located in segment 6. 

7. DISKIO is located in segment 6. This is where the disk queue request block begins. 
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25 CRASH DUMP DEBUGGING APPROACH 



NOTE 



ONCE THE TAPE DUMP HAS BEEN READ IN, WE MUST DETERMINE WHAT WENT WRONG. 
THE FOLLOWING PROCEDURE IS SOME BASIC STEEPS THAT SHOULD BE TAKEN WHEN 
ANALYZING ALL TYPES OF CRASH DUMPS. 

WITH THE AID OF THIS STUDENT GUIDE AND OTHER REFERENCE MATERIALS YOU WILL BE 
ABLE TD EXAMINE THE CRASH DUMPS AND ATTEMPT TO RESOLVE THE PROBLEMCS) IN A 
LOGICAL MANNER. THE OBJECTTVE IS TO ELIMINATE AREAS OF THE SYSTEM THAT MAY 
NOT BE A FACTOR IN A PARTICULAR DUMP, SUCH AS I/O, MEMORY. CPU, OR PRIMOS. 



ACnONS 



1. DETERMINE THE SYSTEM 

MODEL TYPE, PRIMOS REVISION. 
MICRO-CODE REVISION, AND 
HALT TIME/DATE .THIS 
INFORMATION IS VERY USEFUL. 
REFER TO COMMAND 1. 

2. IF THE SYSTEM TYPE IS 

AN 850, REFER TO 
COMMAND 2 TO DETER- 
MINE WHICH CPU (ISU) 
HAS HALTED JF NOT AN 
850, CONTINUE WITH 
ACnON 3. 

3. DETERMINE WHAT USER WAS 

EXECUTING WHEN THE SYSTEM 
CRASHED (LIVE USER). 
REFER TO COMMAND 3. IF 
SYSTEM TYPE IS AN 850, 
THERE IS A LIVE AND LAST 
USER FOR BOTH PROCESSORS. 
REFER TO COMMAND 3a. 



COMMANDS 



1. USE THE DATE 
COMMAND. THE HALT 
TIME/DATE WILL BE 
DISPLAYED ON THE TOP 
LINE, FAR RIGHT. 



2. USE THE RD AP COMMAND 
(REGISTER DUMP FOR ASSO- 
CIATED PROC) AT LOCATION XXXX, 
IF CONTENTS-041004, ISU#1 
HALTED. IF CONTENTS-102010, 
ISU#2 HALTED. 



3. USE THE RP -LIVE 
COMMAND TO DISPLAY THE 
LIVE USER AND REGISTER PRINT. 

3a. THE LIVE AND LAST USER 
COMMANDS ARE AS FOLLOWS. 
FOR ISU#1, RP -UVE 
AND RP -LAST. FOR ISU#2, 
RP -LIVE -SLAVE AND 
RP -LAST -SLAVE. 
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ACTIONS 



COMMANDS 



4. ACQUIRE MORE DETAIL OF 
THE UVE USER SUCH AS, 
(IXJSER NAME,(2)PR0CESS 
1D,(3)LAST WATT LOCATION. 
(4)USER PRI0RITYX5)L0CKS 
OWNED. REFER TO COMMAND 4. 



4. USE THE STATUS <uscr#> 
COMMAND FOR MORE DETAIL 
OF THE LIVE USER OR 
ANY USER. 



FIND THE MODULE IN WHICH 
THE UVE USER WAS EXECUTING. 
REFER TO COMMAND 5. NOTE: 
this is normally con- 
sidered the halt location. 



5. USE THE LOSEARCH 
XX/XXXXXX COMMAND FOR THE 
EXECUTING MODULE NAME. 
XX/XXXXXX BEING THE PB 
REGISTER ADDRESS TAKEN 
FROM THE STATUS INFO. 
OR THE RP LIVE INFO. 



6. EXAMINE IN MORE DETAIL 
THE STEPS THE LIVE 
PROCESS TOOK, UP UNTIL 
THE SYSTEM HALTED. THIS 
IS DONE BY RETRACING 
THE UVE USERS PROCESS 
STACK. REFER TO COMMAND 
6. 



6. THE TRACE <iiser> COM- 
MAND WnX ALLOW YOU TO 
TRACE A USERS STACK FRAMES. 
SUBCOMMANDS AUOW YOU TO 
EXAMINE INDIVIDUAL STACK 
FRAMES IN MORE DETAIL 
SUCH AS THE DMSTK 
COMMAND. 



NOTE 



UP TO THIS POINT, WE HAVE DETERMINED WHO THE CURRENT AND LAST RUNNING 
USER WAS AS WELL AS, WHERE THE USER HALTED AND THE STEPS IT EXECUTED 
PRIOR TO, AND UP UNTIL THE SYSTEM HALTED OR HUNG. WE'VE ALSO DETERMINED 
WHICH ISU HALTED(850 SYSTEM ONLY). 

THE FOLLOWING STEPS WIU CONTINUE TO BREAK DOWN THE CRASH DUMP EVEN 
FURTHER BY REFERRING TO THE TROUBLESHOOTING FLOW CHARTS. 
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ACTIONS 



COMMANDS 



7. DETERMINE IF THE SYSTEM 
EXPERIENCED ANY CHECKS 
Le. MCHICMMOD^OCCEOCU, 
REFER TO COMMAND 7. 



7. USE THE CHECK COMMAND. 
IF SOME TYPE OF CHECK EXISTS, 
REFER TO FLOW CHART CHIOO. 



8. DETERMINE THE HALT 
LOCATION FROM STEP 5. 
REFER TO COMMAND 8. 



9. IF THE SYSTEM APPEARS 

BE HUNG REFER TO COMMAND 
8 



8 . IF T HE HALT 
REFER TO FLOW 
I F THE HALT IS 
REFER TO FLOW 
I F THE HALT IS 
REFER TO FLOW 
THE HALT IS A 
REFER TO FLOW 
THE HALT IS A 
REFER TO FLOW 



IS A MMOD. 

MM300. 
A BOOTO 

BT500. 

A PAGES_ 

PA600JF 
IPAGF_ 

PF700JF 
PGMPA_ 

PG800. 



9. FOR A SYSTEM HANG PROBLEM 
REFER TO FLOW HG400. 



10. IF NONE OF THE ABOVE 
TYPE HALTS EXIST, 
REFER TO COMMAND 10. 



10. IF NO CONCLUSIVE DATA IS 
ISOLATING THE PROBLEM FROM 
THE PREVIOUS STEPS USE 
THE DOC UTILITY IN AN 
ATTEMPT TO ISOLATE THE 
PROBLEM. 
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• MACHINE CHECK HALTS 



• MISSING MEMORY MODULE HALTS - MMOD_ 



SYSTEM HANGS 



• LABELED HALTS - BOOT0/PAGES_/IPAGF_yPGMPA_ 
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1. Detennine the type of machine 
check by decoding the DSW 
legisters for the appropriate CPU 
type. 

2. If legisteis decode to an EOOC or 
EOCU, refer to CH200-A. 

3. If registers decode to a machine 
check with an internal CPU parity 
error, refer to CH-AIOO-A. 

4. If registers decode to a DMX/IO 
parity error, continue with CHIOO- 
B. 

5. If registers decode to a MMOD_ 
refer to MM300-A. 



^ 



1. Use the LOSEARCH command on 
the machine check location. 

2. Restore the machine check location 
segment and access the offset. 
Backward trace the instructions 
being executed prior to the halt, 
refer to CH-AIOI. 



© 



1. Detennine the last vectored 
interrupt that occurred. This address 
is'Sived for 9000 Bdodel cpu's only. 
/Refer to CH-AIOI. / 
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If a machine check has occurred, a 
parity error exists in the Bystem. 
normally due to bad hardware. In a 
9955 system, a tingle \At parity error 
results in a recoverable machine check. A 
double bit parity error would halt the 
machine. 



This procedure will display the routine 

being executed at the time the system 

halted as well as, the instructions 
executed prior to the halt. 



The last vectored interrupt can be very 
(iseful when attempting to isolate a bad 
controller that could have issued bad 
parity. 
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1. Check for any disk activity. 

2. Check for any discrepancies in the 
disk subsystem such as, DMA 
overruns, controller hangs, or disk 
I/O tuning problems, refer to CH- 
A102-A. 



If any disk activity exists in the sjrstem, 
there should be used disk queue blocks. 
The amount of disk queue blocks 
available will depend on the revision of 
PRIMOS. 



Qi 



1. Use the TT -UIM command to 
Check the user 1 message buffer 
for any disk error messages. 



Any disk errors that occur in the system 
will be displayed on the sjrstem console. 
The user 1 message buffer will contain 
the most recent error messages. 



^ 



1. Check each used disk queue block 
for more detail of each disk 
process. Refer to CH-A102-C. 



Examining each used disk queue block 
will allow you to acquire more data of 
each disk process such as, Cl)the \iser #, 
(2)the partition #, (3)disk statuses, C4)op 
code, and other data. 



If the disk subsystem appears to be fine, 
continue with flow CH102. 
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1. Check for any AMLC controllers 
configured in the system. . 

2. Determine which AMLC controller 
had recently interrupted. Refer to 
CH-A103-A. 



The AMLC phantom interrupt code 
located in lament 4 will contain the 
device address of any AMLC controller 
configured. This area will also contain 
the last AMLC controller that 
interrupted. 



1. If the AMLC controllers do not 
appear to be a problem, refer to 
CH103. 
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^ 



^ 



1. Determine the last user to have 
assigned the tape drive. 

2. Verify that the user still owned 
the tape drive at the time of the 
s3rBtem halt Refer to CH-A104-A. 



^ 



1. Determine whether the user had 
completed its tape process. 

2. Check for any faults or aborts by 
tracing the user's stack and 
checking the user's PCB. Refer to 
CH-A104-C 



^ 



1. If the tape subsystem does not 
appear to be a problem, refer to 
CH104-A. 



The objective here is to determine if any 
tape activity existed at the time of the 
halt and weather or not the tape 
subsystem may of had any effect to the 
system halting. 



Tracing the user's stack and looking at 
the user's PCB should help reveal any 
problems the user may have encountered 
during its tape session. Any problems 
could be hardware or software induced. 
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1. C3ieck the live and last user's PCB 
for any useful data that may help 
find the origin of the problem. 

2. Trace the last user's stack, for any 
fault or aborts that could have 
effected the live process when the 
system halted. Refer to CH-A105-A. 


1 


(i) 


1. Check the file system for any 
inconsistencies. Refer to CH-A105-C 


1 


(^ 


1. Check the page maps for 
consistency. Refer to CH-A105-E 


' 


« 


1. Check the status of all the 
PRIMOS NILOCKS. 

2. Check RSAV are for any register 
information that may be usefuL 
Refer to CH-A105-G. 


\ 


' 


END MCHK_ FIX)W 



< 



Here are some final checks in an 
attempt to find any problems that may 
have been overlooked. The live and last 
user PCB frame and the live and the 
last users stack frame may contain some 
useful data. 



This option checks the unit tables for 
any suspecting hash thread problems. 
Segment 14 will contain the register 
save area for any register information. 



This option checks the HMAP, LMAP, 
and MMAP table for consistencies. If 
any errors have occurred, it will be 
displayed. 



If the problem to the system halt is not 
found up to this point, a suggestion 
would be to run DOC as well a 
referring the tape dump to an anal]^ 
well experienced in autopsy. Do not 
replace any unnecessary hardware. 
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1. Check, and decode DSWRMA. 

2. Determine the amount of eccc 
errora that may have occurred. 
Refer to CH-A200-A. 


Ci) 


1. Use the page check command to 
verify the integrity of the hmap 
and Imap tables. If any 
discrepancies are displayed, refer to 
CH-A200-C 


' 


' 


END EOOC/TCCU FLOW 



J 



Determining the amount of eccc errors 
could help verify the reason why the 
8]rBtem may of halted. Primos will 
record a maximum of 2000 eccc errors 
prior to going to silent mode. The 
DSWRMA register will help break, down 
the errors to the ppn and memory array 
board. 



Because the memory eccc or eccu may 
not be the entire reason for the system 
halting,be sure to verify what other 
processes the CPU may have been 
executing by referring back, to CHIOO. 
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^ 



1. Check for any eccc/eccu memory 
puity errors. 

2. Check the memory page map tables 
for any discrepancies. 

3. Decode the DSWRMA register. Refer 
to MM-A300-A. 



A MMOD_ halt is a memory location 
that has been addressed that either 
doesn't ccist or is unavailable. This can 
be a difficult halt to troubleshoot. The 
problem is normally hardware induced 
and can be located in memory, I/O, or 
CPU. 



^ 



Check the DSW registers for any 
I/O operation being executed from a 
controller that could have issued a 
bad address. 

Determine what controllers may 
have issued a DMX request or has 
just completed a DMX operation. 
Refer to MM-A30(K:. 



If the MMOD_ halt occurred during a 
DMX request or DMX transfer, the halt 
could have been caused by a bad address 
issued from a ccmtroUer. Possible 
incorrect values in the DMA 
registers4nic cells, dmt channel 
programs/)r dmq headers. 



END MMOD_ FLOW 
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1. Uae the STAT US oonunand . to 
check the amount of active \uera. 

2. Check the teady/wait list. 

3. Determine if the majority or all of 
the active users are waiting on the 
same semaphore. Refer to HO-A400- 
A. 



^ 



Check the PCB of the live and 

last user as weU as other users 

that are suspected of hanging the 

system. 

Determine what NILOCKS may be 

owned by any suspected user(s). 

Refer to HG-A400-C 



^ 



1. Check for any I/O activity that 
may have caused the system to 
hang. 

2. Check the system micro code 
revision for any reported problems. 
Refer to HG-A400-D. 



END SYSTEM HANG FLOW 



System hangs can be very difficult to 
troubleshoot because the amount of data 
available is very limited. The problem 
can be hardware,software» or micro code 
induced. The most effective means of 
problem isolation is to begin 
troubleshooting the pxm area. 



Because the backstop process does not 
wait on a semaphore and runs when the 
pxm is less active and the clock process 
preempts any process at certain time 
intervals, steps 1 and 2 are not necessary 
if the live process is the clock or 
backstop. 



It can be very common for an I/O 
controller to cause a system hang, 
especially communication controllers. 
Determining what I/O process may have 
been running when the system hung, can 
prove to be good practice in isolating the 
cause of the hang. 
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1. Check the iiser 1 message buffer. 

2. Trace the live user's stack. Refer to 
Brr-A500-A. 


\ 


(i) 


1. Check for any significant changes 
or modifications in the system 
configuration. This would include 
the hardware and software. Refer 
to BT-ASOOC 


1 


(^ 


1. Check for any unusual activity in 
the disk subsystem and the 
communications area. This may 
help when problem isolation is 
difficult for this particular halt 
Refer to BT-A500-E. 


' 




END BOOTO FLOW 



L 



< 



High level langxiages normally call the 
boot routine to halt, which normally 
halts the machine at BOOTO. This halt 
is normally software induced but, can be 
hardware related. 



This halt can tend to appear after 
PRIMOS or some other high level 
langiiage has been modified or revised. 



If PRIMOS modifications may perform 
differently from machine to machine due 
to differences in the system 
configuration. Checking for unusual 
events could help isolate these t3rpe 
problems. 
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1. Check the fault address of the Uve 
user. 

2. Check the live user's stack to 
reveal any repetitive faults that 
may have occurred that could have 
corrupted or trashed the unwired 
ringO stack. Refer to PA-A600-A 



^ 



1. check for excessive disk and/or 
network activity. Refer to PA- 
A600-C 



^ 



1. Check memory for any 

discrepancies or inconsistencies. Refer 
to PA-A600-E. 



END PAGES_ FLOW 



PA600 



V 



s 



A PAGES_ halt indicates that a page 
fault has occurred in the unwired ringO 
stack in segment 6003. This halt is 
handled by the software in the ringO 
fault table. This problem can be either 
hardware or software induced. 



Excessive paging or disk errors during 
paging process could have an impact on 
the unwired ringO stack becoming 
overflowed or trashed. Excessive 

network errors due to bad hardware 
could also cause the unwired ringO stack 
getting trashed. 



Unreliable hardware in the CPU and 
memory will have an impact on this 
halt when referencing areas of memory 
due to paging. 
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m 



1. C3ieck the live users stack for any 
faults. 

2. Check memory for any 
discrepancies or inconsistencies. Refer 
to PF-A700-A. 


(i) 


1. Check for any I/O activity. Refer 
to PF-ATOOC 


' 


® 


1. Check for the interrupt stack 
(segement 4) being overflowed. 
Refer to PF-A700-E. 


1 


' 


END IPAGF_ FLOW 



This halt normally occurs when a page 
faiilt has occurred while hardware 
interrupts are inhibited. This halt is 
handled by the software in the interrupt 
fault table but, can be hardware or 
software induced. 



A bad device interrupt issued from a 
controller could cause an IPAGF_ halt. 



An excessive amount of paging activity 
and interrupt activity could have an 
impact in the interrupt stack being 
overflowed, this is normally due to a 
problem with PRIMOS. 
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Qi 



1. Check memory for any 
discrepancies or inconsistencies. 

2. Trace the live user's stack for any 
process faults. Refer to PG-A800-A. 



This halt normally indicates that, the 
address of a page map entry was just 
calculated but is not in a segment that 
contains page maps. This halt is 
normally hardware induced, usually the 
CPU or memory. 



® 



1. Check the live user's PCB frame. 

2. Check the live user's page map 
tables for an invalid page map 
entry. Refer to PG-A800-C 



Checking the live user or suspected user's 
PCB frame will contain any fault 
addresses and any abort flags that may 
have occurred. 



END PGMPA_ FLOW 
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1. If registers decode to an icm parity 
enor, replace cs board or the CPU 
hardware that oontams the roc 
logic. If not, continue. 



The rem logic is a register located on 
the cs board that is UKd as a pipeline 
register to hold the contents of the 
current microword being executed. This 
logic is aU. microcode controlled and the 
microcode must be reloaded if a parity 
error occ\irs in this logic. 



^ 



1. If registers decode to a parity error 
detected along the BPA or bma, 
replace the associated CPU logic(i.e. 
cs board, j board, a board), 
providing an I/O controller did not 
pass along bad parity to the CPU. 



The I/O controllers interface to the CPU 
along the BPA and BPD buses, any bad 
parity detected along this bus can be 
initiated by either the CPU or the I/O. 



^ 



1. If the I/O is suspected as the 
problem, refer back to CHIOO and 
continue debugging the I/O. 
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1. If an £10 instructioii is found 
prior to the machine check location, 
then decode EIO addressCrefer to 
lys. arch guide). The EIO address 
will also display the register name 
which contains the device address 
located in the KP -LIVE display. 

2. The device address that is displayed 
in the address most likely caused 
the halt providing the cpus i/o 
interface (CS BD.) did not generate 
the parity error. This may be 
confirmed by the PIO instruction 
type. 



^ 



1. If no conclusion at this porat, refer 
to CHIOO-C 



^ 



1. Dump segment 14 locations 2400 - 
2477. Location 2432 will contain 
the vectored interrupt address, Le. 
DUMP 14 2400 2477. 

2. Use the LOSEARCH command on 
the vectored interrupt address in 
segment 4 to display the interrupt 
process, i.e. LOSEARCH 4/<vec add>. 

3. The controller associated with 
interrupt process could be suspected 
bad. 



® 



1. Continue to isolate the I/O, refer to 
CHIOI. 



7 

CH-AlOl 

V 



J 



The EIO instruction is performed by 
program to implement I/O. This 
instruction will send control information 
to a peripheral device as well as move 
data between a device and the cpu. The 
EIO instruction is not used for DMX 
transfers. 



The cpu monitors the I/O backplane for 
any interrupt requests. There are two 
types of interrupt modes standard and 
vectored- The controller supplies it's 
vector address along the BPA in vectored 
mode, whereas tiie software routine 
supplies the pointer address to the 
iaterrupting controller in standard mode. 
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1. Use the DD -USED cxunmand to 
display any disk, queue blocks 
currently in us e. 

2. Use the DD -METER command to 
verify if any problems with disk 
I/O has occurred. Note: aU values 
in the disk metering are 
accumulative. 

3. If the disk meter dii^layed any 
dma overruns or registered any 
controller hangs, a problem exists 
in the disk subsystem. Most 
probable cause could be a disk 
drive, disk controller, or a cable. 
Continue with flow to further 
isolate. 



^ 



1. If disk activity exists, refer to 
CHIOI-B. If no activity exists, refer 
to flow CH102-A. 



^ 



1. Use the DD <dqb #> command to 
display the disk queue block in 
detail Together with the steps 
shown above, this wiU help isolate 
the problem to the partition level 
as well as the user who initiated 
the disk process. 

2. Trace the stack of the user 
displayed in each active disk queue 
block and check, for any faults or 
aborts that may have occurred. The 
problem may have occurred due to 
unreliable disk media or the disk 
drive hardware. 

3. If a problem is suspected in the 
disk subsystem, it should be 
isolated at this point. 



^ 



If the disk susbsystem appears to be 
fine, continue with flow CH102. 



If there are no disk queue blocks in use, 
then most likely there was no disk 
activity. If the disk meters show any 
significant erton, then the disk 
susbsystem could be suspected as the 
source to the problem. 



Any disk errors that may be displayed 
in the console message buffer should 
help in guiding you to the suspect drive 
or controller. Further isolation can be 
made with the following steps shown 
below. 



The disk queue blocks will display 
numerous amount of data which is 
helpful in further isolating the problem 
to a disk drive, controller, or partition. 
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1. Check the AMLC phantom 
interrupt code (PIC) located in 
segment 4 locations 105 - 124. If 
no AMLC controllers are 
configured, refer to CH103-A. 

2. Check the AMLC common interrupt 
handler located in segment 4 
location 436. Use the restore 
command in order to use symbolic 
mode. At location 436, there will 
be a DAC instruction pointing back 
to the location of the last 
interrupting AMLC device address. 



^ 



1. If the LIVE or LAST user was an 
AMLC process, then the 
interrupting controller address 
found from the previous step can 
be suspected bad. 

2. If the last vectored interrupt was 
an AMLC process, then the 
interrupting controller address 
found from the previous step can 
be suspected bad. 



^ 



If the AMLC controllers do not appear 
to be a problem, refer to CH103-A- 



7 

CH-A103 

v^ 



Checking the AMLC PIC code and the 
AMLC common interrupt handler display 
the AMLC controller addresses, if any 
are present as well as, the last AMLC 
controller that interrupted. 
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1. Dump lament 4 locations 207-212 
(MTFTRS;. These locatioiu will 
oo&tain the user pcb number ^^^o 
used the tape subsystem last 

2. Dump segment 6 locations 
23177-23203 CMTILCK) and 
segment 6 locations 23204-23207 
(KrnLCK). These locations will 
contain the user number who has 
the tape drive assigned to it 



Ql 



1. If no tape activity exists, refer to 
CH104-A. Otherwise, continue with 
CH103-B 



^ 



1. Use the TTY <user #> command 
to check, the user's tty buffer who 
last owned the tape drive to 
determine if it ever completed it's 
tape utility. Qjntinue to isolate 
tape subsystem with the following 
steps. 

2. Use the TRACE <user #> and the 
PCB <U5er #> command to check 
the user's stack and pcb frame for 
any faults or aborts that may have 
occurred due to bad hardware or 
possibly a software problem. Verify 
the hardware before suspecting the 
software. 



CONTINUE 



These lo cations contain the mag tape 
pointersCMTTTRS),mag tape 1 lock and 
mag tape 2 lodcCKfTlLCKAn^LClO is 
useful hi isolating the tape subsystem. If 
any tape activity was present, these 
areas will contain the USER ID 
currently using the tape subsystem. 



The user's tty buffer should display if 
the user ever completed it's tape session 
with the message "magrst or magsav 
completed". 
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1. If the LIVE or LAST user was a 
tape process, then the tape 
subsystem can be suspected bad if 
any problems were found from the 
previous steps. 

2. If the last vectored interrupt was a 
tape process, then the tape 
susbsystem can be suspected bad if 
any problnns were f oxuid from the 
previous steps. 



^ 



1. Use the TT -UIM message 
command to verify if any tape 
activity was performed from the 
system console. There are potential 
problems when using the system 
console for MAGSAVS and 
MAGRSTS. 



Ql 



If the tape susbsystem does not appear to 
be a problem, refer to CH104-A. 



MAGSAVS and MAGRSTS should not be 
executed from the system console due to 
it's priority. The system console receives 
messages constantly and if the console is 
busy with MAGSAVS or MAGRSTS, the 
messages must wait thus, potentially 
causing a hang or a halt. 
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1. Um the PCB <iuer #> command to 
display the user's pcb formatCiefer 
to lys. atch. guide). C3ieck. for any 
abort flag bits enabled that may 
have generated a user process fault. 

2. If any faults are found from the 
previous step, it may have an 
impact on the system halt At this 
point use the trace <nser #> 
command to check the user's stack 
for the subroutine being executed 
when the fault or abort may have 
occurred. 



^ 



1. If no conclusion, refer to CH104-B. 



^ 



1. Check the file system with the FS 
command. If any inconsistencies are 
encountered, the unit tables 
involved will be displayed. 

2. If any problems are found from 
the previous step, use the UTE 
<user #> <ute #> command to 
further isolate the particular 
problem. The problem could be 
related to a disk drive problem or 
the disk media. 



^ 



1. If no conclusion, refer to CH104-C 



CONTINUE 



-< 



The pcb frame as well as the user's 
stack may reveal some useful dau that 
m ay have been overlooked. The 
SYSTEM'S ARCHITECTURE GUIDE has 
the pcb format breakdown. 



The file system check, as well as 
checking the file unit tables, coiild help 
determine any problems that may exist 
with the hash tables possibly due to a 
hardware problem in the disk subs3rstem. 
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1. Uw the PA command to check the 
page map tables. Any exion will 
di^lay the segment and page 
number in error as well as the 
user number. 

2. Use the PM <segment #> <user 
#> command to further isolate the 
error. The problem could be 
related to a memory eccc error or 
memory could be configured 
incorrectly. 



Qiecking the page map tables could help 
find a problem with memory that may 
have not been displayed by the machine 
check option such as memory eccc's or 
possibly a hole in the memory 
configuration. Note: for model 850 system 
only, segment 4 page 77 will be 
displayed as not available. Disregard 
this message. This portion of memory is 
wired aside for the SSU board. 



SI 



1. If no conclusion, refer to CH104-D 



^ 



1. Use the LOCKS command to 
display the NILOCKS status. Check 
for any abnormalities. 

2. Qieck the RSAV area in segment 
14 locations 2000-3777. 



END MCHK_ FLOW 
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1. To verify if any memory eccc 
errors have occurred, you must 
firat use the SYMBOL command 
on ECXX3^T (SY EOCCST). This is 
the area in primes where memory 
eocc errors are recorded. 

2. Use the SESTOBE command to 
access the location from the 
previous step On ootid). The 
amount of eccc's the system 
encountered Of any) will be 
displayed. Replace the appropriate 
memory chipCs) or boardCs). 



^ 



1. If no conclusion, refer to CH200-B. 



^ 



1. If any discrepancies are displayed 
from the PAGECHECK command, 
the user and segment number will 
be displayed. Note: for model P850 
system only, segment 4 page 77 
will be displayed as not available. 
Disregard this message. This portion 
of memory is wired aside for the 
SSU board. 

2. Use the FM <segment> <user #> 
command to acquire more detail of 
the particular portion of memory 
that primos has flagged as a 
problem. The problem could be 
related to the eccc/eccu errorCs) due 
to bad hardware in the memory. 
Note: be sure to check logrec for 
any memory errors. 



END EOOC/EOCU FLOW 



If a memory parity error occurred 
during a DMX transfer could halt the 
machine with a MACHINE CHECK 
therefore it's important to check for any 
memory eccc's when troubleshooting a 
MACHINE CHECK dump. 



The page map table check command wUl 
display a 64 word HMAP and a 64 
word LMAP table, respectively. 
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MM- 



V 

r 



A300 



V. 



J 



^ 



1. To determioe if any memory eocc 
or eccu errors exist, use the 
procedure outlined in flow CH- 
A200-A. If any exist, replace the 
appropriate memory hardware. 

2. To determine if any memory 
discrepancies exist in the page map 
tables, use the procedure outlined in 
flow CH-A200-B. 

3. If the DSWRMA register is valid, 
it will contain the last memory 
address referenced. This could 
become useful if a DMX operation 
was in progress. 



Ci) 



1. If no conclusion, refer to MM300-B 



Si 



1. If The DSW registers indicate an 
I/O or DMX operation in progress, 
use the procedure outlined in flows 
CH-AlOl thru CH-A104 to isolate 
a bad I/O controller or bad CPU 
hardware that may have caused 
the problem. 



^ 



1. Once the I/O and the MEMORY 
have been ruled out as the 
problem, isolate any logic of the 
CPU that may be suspected bad in 
the operation that has just been 
executed. 

2. If I/OJ^IEMORY, and the CPU 
cannot be isolated to any suspected 
bad hardware, run the DOC utility 
(refer to DOC USER'S GUIDE). 



END MMOD_ FLOW 



The objective in this flow is to isolate 
any memory problems that may have 
surfaced from a memory address being 
referenced by stack pointers, indirect 
pcnnters, or a DMX transfer during an 
I/O operation. 



If the I/O does not appear to be the 
problem, the CPU logic could be 
suspected bad. Checking the I/O path for 
the operation that has been executed 
could help isolate the bad CPU 
hardware. 
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1. The STAT US command will 
display the user's logged in as well 
as the ready/wait status, locJu 
owned, and their base registers. 

2. Use the RESTORE command to 
look at the ready list located in 
segment 4 beginning at location 
6M)Crefer to PRIMOS internals 
guide). If there is an excessive 
amount of users in the ready list 
on level 626, this could indicate a 
problem wi^ the scheduling of 
users or executing the ready user's 
processes, possibly due to a 
software or hardware problem. 
trace the ready users stack to 
determine what routines they may 
have been executing. If aU the 
ready users were attempting to 
execute the same routines, this 
oould be an indication of a 
software problem with that 
particular routine. 

3. Use the LOSEARCH command on 
the user's "waiting at" locations 
acquired from step 1. If the 
majority of the users appear to be 
waiting on the same semaphore, 
this could also indicate a problem 
with the scheduling of users most 
likely, the majority of the processes 
calling on the same routines. This 
also can be software induced. 



J® 



1. If no conclusion, refer to HG40(>-B 



CONTINUE 



7 

HG-A400 

k 



< 



The objective of looking at the PXM, 
will help in determining what processes 
may have been executing at the time of 
the system hang, as well as processes 
waiting on aemephores that may be 
significant to the tystem hanging. 
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1. Uk the PC8 <USEE #> oommand 
to check for any user's that may 
have acquired any process fault or 
process aborts. This information 
may be useful in determining why 
there is a heavy load in the PXM. 
If any faults or aborts did occur, 
trace the user's stack to determine 
what routine may have caused the 
problem. 

2. Use the LOCKS command to 
display what locks are owned. If a 
lock problem exists, accessing of 
critical data bases could possibly 
cause The heavy process exchange 
overhead therefore, a hang could 
occur. This normally indicates a 
software problem. If the PXM 
appears to be fine, refer to HG400- 
C 



^ 



1. To determine if any i/o activity 
may have caused the S3r5tem hang, 
refer to procedure outlined in in 
flows CH101-CH103. 

2. Check any CSBs or FCOs that may 
have any information related to 
known S3rstem hangs due to 
microcode. 



END SYSTEM HANG FLOW 



7 

HG-A400 

CONT. 



J 



The data acquired from steps 1 and 2 
can become helpful in isolating any 
faulting routines or accessing of critioil 
data bases due to a lock problem. 



If a problem exists in the I/O, it is 
frequently d related to a comms 
controller. Occasionally, the system could 
appear it's hung but is actually ru nnin g 
very slow due to excessive 
communications or possibly an 
applications problem. Be sure to check 
what I/O process may have been active 
when the system hung. 
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BT-A500 

k 



-< 



& 



1. Use the TT -UIM -CRLF 
commaiid to view the uset 1 
menage twf fer. An erior message 
of some kind should be displayed 
on console prior to the system 
halting at BOOTO. This message 
should help determine what routine 
could have failed. 

2. Use the TRACE <USER #> 
command to retrace the steps the 
live user executed prior to calling 
BOOT. The displayed subroutines 
should reveal any problems. The 
problem is usually software related. 



1. If no conclusion, refer to BT500-B. 



^ 



1. Some general problem areas to 
check for would be: 

• Has PRIMOS been changed 
recently ? 

• Is PRIMOS modified 7 

• Any new programs running ? 

• Was any new microrade 
installed recently ? 

2. If any of the above changes exist, 
be sure to verify the integrity of 
the product under an operating 
system load. 



(21 



1. If no conclusion, refer to BTSOOC 



Most routines that fail and call BOOT 
will print an error message at the 
system console prior to ludting the 
system with BOOTO. The BOOT routine 
waits for the sjrstem console output 
buffer to be flushed prior to halting at 
BOOTO. The console message is a key 
factor in determining what routine may 
have failed. 



BOOTO halts tend to appear after some 
recent change has been made in the 
software or possibly after PRIMOS 
modifications. 
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CONT. 
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1. Uie the FS oommand to check the 
file syBtem for any problems that 
may exist with the file system. 

2. Use the TRACE command to 
determine if live user's stack trace 
indicated any conditions signaling a 
"PAGING DEVICE FULL" or 
perhaps a "LOGIN DISOONNECT- 



Certain conditions can tend to cause 
BOOT) halts such as, PAGING DEVICE 
FULL, file units not closed on UTDALC, 
LOGINS or LOGOUTS, LOGABORTS, and 
LOGIN DISCONNECTS. Check for these 
type of conditions in the live user's 
stack. 



END BOOTO FLOW 
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® 



1. Use the RP -LIVE command , the 
Twister print will display the fault 
address. If the faxilt address 
contains 6003/20000, this indicates 
that the iinwired RingO stack, has 
been overflowed. 

2. Trace the live user's stack and 
check for any recursive faults or 
conditions such as "SIGNALS". 
Tliese occurrences could corrupt the 
unwiied RingO stack. This is can 
occur from hardware problems 
with the disk subsjrstem or the 
network. 

3. A trashed unwired RingO stack can 
occur from frequent user procedure 
calls such as "R$CALL". This is 
normally due to bad CPU 
hardware or a peripheral device. 



^ 



1. If no conclusion, refer to PA600-B 



Use the procedure outlined in flow 
CHlOl to check for any disk 
activity. 

Use the procedure outline in flow 
CH102 for any network activity 
present Any network activity with 
recursive login aborts, logins, or dcd 
drops could overflow the unwired 
RingO stack. 



^ 



1. If no conclusion, refer to PA600-C 



CONTINUE 



The unwired RingO stack is only 
allocated 8 pages, located in segment 
6003. A process runs out of unwired 
RingO stack at address 20000. The page 
faxilt handler checks the fault address 
prior to halting the machine. 



Certain conditions that can normally 
trash or overflow the unwired RingO 
stack is, paging device ful^disk errors, 
excessive attach points, Iqgins, log aborts, 
and output bxiffers full. 
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PA-A600 

CONT. 



CD 


1. Use the PAGE command to check 
memoiy for any inconsistencies. If 
any exist, use the proceedure 
outlined in flow CH200. 


^ ' 


END PAGES_ FLOW 
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1. Trace the live user's stack to reveal 
any faiilts and fault types. An 
ezoeasive amount of faults in the 
luer*! stack could indicate a 
hardware problem related to the 
particular process. 

2. Use the Page command to verify 
if any problems may exist in the 
page map tables which could have 
possibly induced the problem. 



^ 



1. If no conclusion, refer to PF700-B 



c 



1. Use the procedure outlined in 
flows CH101-CH103 to isolate any 
I/O related problem. 

2. Check for the last vectored 
interrupt outlined in flow CH- 
AlOl-B. 



7 

PF-A700 



-< 



Separate tables exist for interrupt process 
vs. user process. Some faults are legal 
for a user process but not for an 
interrupt process. The user stack will 
reveal any faults that nuiy have 
occurred. 



Systems running many comms controllers 
could be a factor in an IPAGF_ halt 
due to the fact that they all use the 
same interrupt stack. This could 

contribute to the interrupt stack 
becoming overflowed or a bad interrupt 
address caused by a bad controller. 



1. If no conclusion, refer to PF700C 



^ 



1. Use the Sjrmbol command to find 
the location of SEG4SZ(SEGMENT 4 
SIZE). 

2. Use the SESTOKE command to 
look at location and 1 of 
segment 4. 

3. The value acquired from step 2 
should not be greater that the 
value acquired from step 1. If the 
value is greater, then the interrupt 
ftack has been overflowed. Tids 
problem is software related. 



END IPAGF_ FLOW 
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All interrupt processes use the same 
stack therefore, the interrupt stack could 
become overflowed due to excessive page 
faults. Page faults cannot be handled by 
the interrupt process, all memory for 
them must be wired. 
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1. Uae the PAGE command to verify 
the integrity ci the page map 
tables. If any erroxa exist, uae 
procedure outlined in flow CH- 
A200-B to further isolate. 

2. Trace the xiaer's stack to reveal any 
ncursive page faults. If any have 
occurred, this may be related to an 
invalid PMT entry on the page just 
referenced. 



PG-A800 



The software stores the segment number 
in the stack before doing calculations. 
After restoring from memory into the L 
register, the L register becomes trashed. 
Replace the CTU board containing the 
register files (El for 9955 and 9950). 



1. If no conclusion, refer to PG800-B. 



^ 



1. Use the PCB <USER #> command 
to reveal the iiser's fault vector 
and concealed stack frame (refer to 
Systems Arch- Gmde). These areas 
will contain specific data about the 
page fault(8). 

2. Use the procedure outlined in flow 
CH-A200-B to display the HMAP/ 
LMAP entry for the specified user 
and segment number acquired from 
PG-A800 Al. 




All page faults cause a branch in 
execution through the user's page fault 
vector to the page fault table code. A 
CAlKCall Fault Handler) is then 
executed. The state of the system at the 
time of the fault is saved in the user's 
PCB concealed stack frame. 
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1 Overview 

DOC is an automated crash dump analysis tooL It provides both an analysis which attempts 
to pinpoint the cause of failure and a variety of reports. The reports present various aspects 
of the failed S3rstem's state in a format which enables a knowledgable engineer to tjudyie the 
crashes which DOC cannot handle automatically. The current version of DOC has been 
oriented toward diagnosing hardware failures to the Beld Replaceable Unit. This document 
describes how to run DOC and how to interpret its output. 

DOC is intended to be used as a screening tool to determine the most likely problem when a 
customer calls Central Dispatch. Therefore, the program has the facilities to perform remote 
diagnosis. A separate document describes the configurations and procedures which mxist be in 
place at the customer site to enable remote DOC analysis. 

2 Restrictions on DOCs Use 

The current version of DOC will diagnose failures on P750, P9750, P9950, and P9955 systems 
running PRIMOS Revision 19.1 or later. 

DOC operates primarily by understanding the implications of the values of many stote 
variables in the PRIMOS operating sjrstem. Although the DOC can configure itself according 
to CPU type and PRIMOS Revision, it is unaware of any modifications from the master disk 
versions. Changes in modules which DOC does not use in its analysis are accomodated 
automatically. In particular, the program assumes that all of the DIMs (Device Interface 
Modules) contain the same code as the master disk version of PRIMOS. DOC ignores any non- 
standard devices. The file LOC_VAR_nnnJ'L (where nnn is the revision number) gives the 
names of modules which must not have been changed from the mater disk version. 

The current version of DOC ignores any ICSl controllers in the configuration. DOCs analysis 
will still be valid with the exception that the effects of the ICSl will be ignored. 

3 Performing a DOC Automated Analysis 

3.1 Machine Configuration 

Since DOC performs 'Tlemote Diagnosis", the machine on which the DOC application executes 
must have some communications facilities. Both a connection to a XJ2S public packet 
switching network (eg. TELENET) and an assignable as3nichronous line should be in the 
configuration. The asjrnchronous line should be attached to an auto-dial modem. Particular 
support is planned for the Racal-Vadic Auto-Dial VA212. 

If both the crash dump file (and other required fUes) «uid the DOC application are on the 
same machine, DOC must stUl LOGIN to another user process on the machine. Primenet 
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Remote Login (X^5) should be used in "loopback" mode. Thus, the Primenet software must 
be present and correctly configured on the machine. 

DCXT must have a UFD for its use. The user process MUST be attached to the UFD while 
the application is executing. This is required because IXX7s self -configuring ability loads in 
code modules at run time. The user process running the DOC application requires ALL access 
rights (except the right to change protection) to the UFD because a report of the diagnosis is 
written into the directory. 

Salford Li^/Prolog must be installed on the machine running DOC. This is a non-Prime 
product for which a per CPU license is required. 

4 Learning to Use DOC 

DOC has a menu oriented \iser interface and most operations are "self evident." This 
document will only summarize how to use DOC It is essential to try the program while 
reading this document to gain full knowledge of how to use the DOC application. 

DOC has two modes of operation, DSW decode and crash dump analysis. The crash dump 
analysis has a variety of useful functions which are described below. 

5 DSW Register Decode Using DOC 

DOC has the ability to decode the Diagnostic Status Words of the machines of which it has 
knowledge. In this mode, the information is manually input from the keyboard and no 
connection to a "remote" machine is needed. 

6 Crash Dump Analysis Using DOC 

6.1 Logging in to the "demote" System 

The first step in a DOC crash dump anal3rsis is to login the system on which the crash 
dump and related information is located. The program supports both XJ25 and assignable 
asynchronous line. X.25 is the generic name for Primenet Remote Login and public packet 
switching data networks such as TELENET. When you use X.25, you will be prompted for a 
gystem ttumtL Answer a name which appears in the STAT NET output on the machine 
running DOC or the numeric network address of the remote machine. 

After ph3rsical connection to the remote tytxtm has been accomplished, DOC will ask you to 
login. At this point, your terminal wUl behave as if you are running the NETUNK program. 
That is, your terminal will behave as if it was attached to the remote system. At this point 
you must t3rpe all of the commands and passwords necessary to LOGIN to the remote machine 
and attach to the special directory used on the remote machine for DOC analysis. Commands 
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which use control characters to manipulate the terminal (eg cursor movement) may not work 
correctly. DOC outputs important instructions which should be observed. Commands such as 
ATTACH, USTF, and LD may be given. 

After LOGIN has been accomplished and the process on the remote machine has been attached 
to the proper directory, the command doc_oomm must be entered as if it resided in CMDNOO 
on the remote machine. doc_comm is NOT a cmnmand, but a distinguished string which 
DOC uses to know that the LOGIN function has been acccuuplished. If you input the 
doc_ocmm string as "type-ahead" Qe before the appropriate Primos command prompt has 
appeared), then all following output will not be output on your terminal. The typed-ahead 
commands WILL be processed, but the output will not be displayed. Therefore, it is 
recommended that the doc_comm command NOT be typed-ahead. 

After the doc__comm pseudo-command has been given, DOC will use the remote connection to 
send commands to the remote system. Your terminal will be used to give commands to DOC 

7 Interpreting Results of DOCs Automated Analysis 

Normally, Automated Diagnosis is normally run first. Based on the results of the diagnosis, 
other reports may be run. The following information will help you to interpret the output 
of the diagnosis. 

If the system halted at a halt instruction which is coded into Primes, DOC will tell you 
something about the ca\ise of the halt. Since these halt instructions have been coded into 
Primos by the operating system developers, there is (should be) a specific problem with the 
system detected. Usually, what is detected is an inconsistency in the data structures used by 
Primes. For most "coded" halts, DOC is unable to determine what caused the inconsistency. 
DOC alwa3rs prints out a message giving some kind of explanation of what class of errors 
caused the halt 

7.1 Machine Checks 

Machine check errors are handled fairly completely. In many instances DOC is able to 
determine which boaidCs) are the most likely site of the problem. When the peripheral 
controllers are the cause, the Controller Status Report should be consulted to gain more 
information about which controlleKs) should be suspected. 

JJ2 Missing Memory Module 

Missing Memory Modules have fair coverage. DOC will print out the virtual address which 
caused the missing memory check to be taken. This is the address in DSWRMA. The 
backed-up value of DSWPB is the instruction being executed when mmod check occurred. If 
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the check occurred when DMx was NOT in progress, then the mmod is associated with some 
memory address referenced during the execution of the instruction (eg address of instruction, 
effective address of instruction, indirect pointers, stack pointer, etc). If the check occurred 
DURING DMx. then the check was caused by an address issued by a controller. Coosult the 
Controller Stotus Report to isolate suspects. The contents of DSWRMA may contain some 
address associated with the transfer. If more than one controller was requesting DMx, at the 
time of the check, then DSWRMA may not contain relevant information. Missing memory 
checks are often associated with corrupted virtual memory databases within Primos. Another 
possibility is incorrect values in dma registers, dmc cells, dmt channel programs, and dmq 
queue headers. 

DOC checks for overrun DMC ceUs. If the overrun DMC cell, is associated with an AMLC; 
then a likely cause is an unterminated line. An unterminated line has the effect of inputting 
null characters faster than PRIMOS can empty the tumble table. 

73 Uncorrectable Memory Parity Errors 

Ordinarily, the offending virtual address is in DSWRMA. However, in some cases DSWRMA 
may not be valid. Use the techniques discussed under Missing Memory Module to isolate 
likely addresses. If the check occurred during DMi, then consult the Controller Status Report 
to determine likely transfer addresses. 

lA King Stack Orerflow 

Although thin condition is often caused by software bugs, there are at least two hardware 
problems which can be responsible. If there is an unterminated AMLC line coimected to the 
system which is picking up noise, it is possible that process aborts (PABORT) can be issued 
faster than they can be handled- If there is an uncorrectable disk read error on the unwired 
portion of the Ring Stack, then a stack overflow will result An disk error message will 
appear in User I's message buffer and a page fault on the stack will appear in stack trace of 
the live user. 

IJi Fortran STOP 

This form of coded halt is used by some network related routines. Trace the stack of the 
live_user to find out which subroutine called F$HT (the Fortran STOP routine). Consult the 
source code for that routine. The value of the A-register of the live_user should correspond 
to the number following the STOP statement which caused the halt. 
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7js booto_ and boot_ 

Boot is another form of emergency halt Usually, there is an explanatory message in User I's 
terminal output buffers. DOC will print out these buffers for BOOT halts. 

7*7 Controller Status Report 

The Controller Status Report will print an entry for every controller which is present in the 
configuration and has been used at some time since cold start. For example, if the hardware 
configuration contains a magtape controller but no magtape was ever ASSIGNed; then DOC 
will conclude that the magtape controller is not present and will print no information about 
it 

The information about each controller includes the name of the controller, its device address 
(address used la PIO instructions), if an outstanding DMz request is pending, and the direction 
of the pending transfer. DOC cannot determine if a DMi cycle for a given device was 
actually in progress at the time of the halt; only that the controller has been issued a request 
which will result in DMx and that the operation has not yet completed. 

Information is also printed about the DMx registers and cells used by each controller. The 
type of DMx (DMA, DMC, or DMQ), where the cell is located, the contents of the cell, the 
number of words left to transfer, the virtual address of the NEXT transfer, the Segment 
address which that virtual address has been mapped to, the physical address, and the Primos 
symbolic name for the virtual address. All numbers preceded by a colon are OCTAL. 

DOC cannot determine if a DMT cycle may have been in progress. The disk controllers use 
DMT to access channel programs. Ilius, the disk controllers must be included in a list of 
controllers responsible for an error occurring during DMx. 

7.8 Ready Wait Report 

The Ready Wait Report prints a formatted list of the ready list and of semaphores with 
waiting processes. Each semaphore is associated with an event which a process may wait on. 
Each process is identified by its user number. Processes with negative user numbers are 
interrupt processes. The process numbers are in octaL All numbers preceded by a colon are 
OCTAL. 

The Ready Wait Report can be used to determine if processes are waiting for unusual events 
or if an unusual number of processes are waiting for a particular event The report is 
particularly useful when debugging a hang. 

The live_u8er will be the highest priority ready process. The ready list is printed first by 
priority level and then by the order in which the processes are queued on that level. That 
is, the order of the process numbers corresponds to the order in which the processes will be 
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tun. 

Processes waiting for terminal input are reported as a group even though, each process has a 
separate semaphore for this event. Processes waiting for disk requests and time slice are also 
grouped together. These categories are common events and waiting there is indicative of 
normal system behavior. 

1.9 LOGBUF Contentt Report 

The LOGBUF contains a list of "recent" sj^stem errors or exceptions which would have been 
posted to the LOGBUF file if the system had not halted. Not all of the entries are processed. 
System cold start and disk mount entries are ignored. The information is similar to the 
information which is output by the LOGPRT program. 

7.10 User 1 Output Buffers 

This report prints the content of both the user 1 termintd output buffer and the "message 
buffer." PRIMOS often writes specific error messages which describe the cause before 
executing the halt. These messages are not always actxially printed before the system stops. 

7.11 Autopsy Command 

This option feeds a single command to the AUTOPSY program which is running on the 
remote machine and prints the results. At the current time, commands which resxilt in a 
great deal of output (eg. STATUS ALL) will not work correctly. AUTOPSY commands 
which enter a different command mode (eg. TRACE, RESTORE, VSPD) will leave AUTOPSY 
in that mode. Thus, other DOC functions will NOT work until another AUTOPSY command 
has been issued to exit the mode. 

7.12 Virtual - Physical Address Translation 

Given either a virtual or physical address, this function will supply the complement Since 
hardware deals in physical addresses and PRIMOS in virtual addresses, this command can be 
used to relate addresses suspected in a particular problem (eg. missing memory module). 

7.13 Diagnostic Status Decode 

This fimction decodes the DSW registers as if a machine check had been responsible for the 
halt. Note that the contents of the registers is only guaranteed to be valid after an actual 
check. Thus, the output of this command may be invalid if the DSW registers do not 
contain values from an actual recent check. 
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Site Administrator's Guide for DOC Automated Analysis 

1 Summary 

This document describes the machine configuration and procedures which are needed at a 
customer site to enable remote failure diagnosis by the DOC intelligent crash dump nnalyitT. 
DOC can help diagnose halts or hangs whidi have occurred on systems running PRIMOS 
Revision 19.1 or later on the following CPUs: 750, 9955, 9750, 9955_mod2, 9755, 2450, 2550, 
2655, 9650. and 9655. 

When a hang or halt occurs on a Prime system, the customer's computer room operator 
must take a "crash dump." This operation transfers the contents of the system's user visible 
registers and all of physical memory onto a magnetic tape. Once the tape dump operation has 
been completed the failed 83rstem may be warm or cold started to resume service to users. 
The operator then transfers the information on the magtape into a disk file in a previously 
established UFD. Prime Customer Service is then requested to perform a remote analysis. 

The customer site system administrator must establish a LOGIN-able ufd in which is kept 
the programs used by DOC, crash files to be anal3rzed, and the PRIMOS ring maps for the 
operating S3rstem on the failed machine. The customer site must have some facilities to allow 
LOGIN from a remote terminal, either an X.25 public data network connection (eg. TELENET) 
or an asynchronous line connected to a modem and telephone line. 

2 Establishing a LOGIN Accoimt for DOC 

The DOC program operates by logging into to the customer's machine as an ordinary user 
and running a Prime supplied user level application program. This program accesses the crash 
diimp file from the failed machine and the associated ring maps and sends the requested 
information over the remote link. 

2.1 Choosing a Machine 

If your site has more than one Prime system you should choose one or more of the 
machines to run the DOC nmote diagnosis application. The CPU type of the machine is 
unrestricted - any 50-series system will nm the customer site program. Even the system 
which experienced the faUure may be used, provided it will nm Primos for approximately 30 
minutes. The system must be running PRIMO^ Revision 19.0.0 or later. 

The machine chosen must have some form of remote login capability. If the site has a 
machine which is directly connected to an X25 public network, such as TELENET, then that 
machine would be a good choice. An alternative is a modem connected to an asynchronous 
line used for login. The line should NOT be connected to the system console remote port. A 
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1200 baud Bell 212 compatible modem is preferable, but the system will operate at 300 baud 
using a Bell 103 compatible modem. A nonnal telephone line whose number can be directly 
dialed Oe does NOT go through an operator) should be connected to the modem. The line 
should have no other ertensions and should have no "options" which can cause noise on the 
line. (eg. The line should NOT have "call waiting" since this feature causes a tone to be 
sounded when a second incoming call is made to an already busy line.) Communication via 
X2S public data network is preferred becaxise it offers lower error rates and high speed. 

3 Contents of UFD 

The UFD used by DOC for remote analysis must contain the following files: 

DOC.COMM.RUN 

Prinoa RING mop* with nam«a chongad oppropriottly (S«« b«low). 

Croah Dump Fi laa 

D0C_C0M\1RUN is the application program which is run during DOC analjrsis. It is 
identical to AUTOPSY with the name changed. 

The crash dump should be transferred from tape to disk, using DOC_COMM.RUN. 

OK, ASSIGN MTe 

OK, AT dumps.ufd 

OK, RUN DOC.COMI 

> raod <nana you wiah to giv* to dump on tha tapa> 6 

The RING maps are the "SEG load maps" of the version of PRIMOS the failed machine was 
running at the time of the failure. There arc two files. At a site running unmodified 
PRIMOS, the RING files are the files RINGOJMAP and RING3AIAP from the master disk UFD 
PRIRUN. The names of the fUes must be renamed to append the PRIMOS Revision number to 
the end of the name. For example, if PRIMOS Revision 19.1.1 is being run, then the master 
disk fUe PRIRUN>RING0A1AP should be copied into the UFD as RINGOMAP.19.1.1 If the site 
is running more than one operating system revision (on different machines or at different 
times), then the UFD used by DOC should contain a pair of appropriately named RING maps 
for each version. If the site has modified and reloaded PRIMOS, then it is important that the 
maps from the modified system be used. The RING maps MUST match the operating system 
version for DOC to give accurate diagnosis. The revision number that a system is currently 
running can be determined by giving the PRIMOS command 'STAT SYSTEM". The command 
prints the revision number on the user terminal. Alternatively, if the failed S3rstem is 
unavailable, run DOC_<X)MMRUN on the dump being analyzed. That is: type r doc_comm 
<dump__name> in PRIMOS. DOC_CX)MM will tell you the exact name of the ringO map it 
is looking for (if it does not find it in the same uf d as the DOC_COMM program program 
itself). Rename the failed machine's ring maps to match the names sought by 
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DOC_OOMMJlUN. 

The LOGIN account used by DOC needs only READ access to the files in its UFD. DOC 
accesses ONLY the files in its UFD. (Note: The Customer Service Engineer running DOC may 
use LISTF or LD to verify the contents of the UFD during the process of starting the 
•nalsrsis but this capability is not essentiaL) The site administrator may restrict access of 
DOCs LOGIN account appropriately. The LOGIN account used by the computer room operator 
to transfer crash tapes into the UFD will, a£ course, need all access rights except the right to 
change protection. 

The size of each crash dump file is determined by the amount of physical memory on the 
failed system. The dump file has one disk record for each 2KB of physical memory. Dump 
files may be deleted after analysis but the original crash tape should be retained until it is 
certain that the problem has been resolved. 

4 Computer Room Procedures 

The site should establish a procedure to ensure that a crash dump tape will be taken 
EVERY time there is a S3rstem hang or a halt. The procedure for taking a crash dump tape 
is given in the Prime System Operator's Guide (DOC5038-19x) in Chapter 13 as action D in 
Table 13-2 Recovery Procedures. For machines not equipped with the VCP Ge has knobs and 
switches type control panel), see appendix E, Table E-2. A supply of blank or "scratch" tapes 
should be located physically near the machines. The tape dump operation should take well 
under five minutes even on a large memory configuration machine, including the time to 
mount the tape. 
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The procedure for taking a crash dump tape on a system equipped with a Virtual Control 
Panel (VCP) is as follows: 



la. If the machine is hung Ge the red stop light is off and no 
lialted at" message has been printed on the system console, 
then the system must be manually stopped. Do NOT use the 
SYSCLR button on the system cabinet Instead, use the VCP 
command STOP. If the console is not in "VCP mode", then 
type <ESC> <ESC>. Ge. Press the ESC key twice.) The 
console prompts 'CP> ' when in VCP mode. 

lb. If the machine fails to respond to the STOP command, then 
press the SYSCLR button located on the front face of the 
system cabinet near the top. This method of stopping the 
system will not save the live registers but DOC will still 
be able to perform an analysis. DOC assumes in that step 
la above has been tried and has failed to halt the machine 
as fact that it uses in its reasoning process. 

2. Mount a tape, with the write ring in place, on Drive 0. 

3. Enter the SYSCLR command. CP> SYSCLR 

4. Enter RUN 775. CP> RUN 775 

The crash dump will be written on the upe and then the 
tape wiU rewind. If the tape does NOT rewind, start at 
step 2 with a different tape. 

5. Dismount the tape and remove the write ring. 

Label the tape with the date and time and the machine name 
Gf more than one machine at site). 

6. Warm or Cold Start the machine according to instructions in 

the System Operator's Guide and established site procedure. 

7. Record the dump action with identif jring tape number in the 

system logbook together with any "special circumstances" 
relevant to the problem. 



5 Reqaetting a DOC Analysis ^ 

When the tape contents have been transferred to a file in the UFD set up for DOCs use, 
a call should be made to request analysis. You will need to supply the following 
information. 

1. The complete X.25 public data network address of the machine 
or the telephone number of the dial-up LOGIN asynchronous line. 



Adminstrator's Guide DOC Automated Anal3reis Page 4 



Version 20.1 



2. Instructions on how to LOGIN to the system including the user 

id and password of the account set-up for DOC diagnosis. Make 
certain to give ALL information needed to LOGIN to the machine 
including additional passwords and billing accounts numbers if 
they are used at the site. 

3. The name of the UFD and crash file. It should always be named 

CRASH.ticket_]ir. If you are using the obsolete pasBword 
protection, the NON-OWNER password to the UFD Of not blank) 
must be supplied. 

4. The name and "serial number" of the failed system so that the 

Customer Service Engineer can identify the mufthinf 

5. Any information relevant to the problem which has been noted 

the system logbook or is otherwise known. 



Adminstrator's Guide DOC Automated Analysis Page 5 




Adminstrator's Guide DOC Automated Analjrsis Page 6 



